Add camera orbit control

README.md

@@ -9,6 +9,7 @@ The node is registered as:
 - `prompt_builder / SxCP Seed Control`
 - `prompt_builder / SxCP Seed Locker`
 - `prompt_builder / SxCP Camera Control`
+- `prompt_builder / SxCP Camera Orbit Control`
 - `prompt_builder / SxCP Category Preset`
 - `prompt_builder / SxCP Cast Control`
 - `prompt_builder / SxCP Generation Profile`
@@ -54,8 +55,8 @@ node. For cleaner workflows, use the split nodes:
 The practical compact workflow is:
 
 `Category Preset` + `Cast Control` + `Generation Profile` + optional
-`Advanced Filters`, `Seed Locker` or `Seed Control`, `Camera Control`,
-`Woman Slot` / `Man Slot`, and `Character Profile`
+`Advanced Filters`, `Seed Locker` or `Seed Control`, `Camera Control` or
+`Camera Orbit Control`, `Woman Slot` / `Man Slot`, and `Character Profile`
 into `Prompt Builder From Configs`.
 
 An importable default workflow is included at
@@ -178,9 +179,10 @@ you like, choose one `reroll_axis`, and connect its `seed_config`. All other
 axes stay frozen to `base_seed`; the rerolled axis follows `reroll_seed`, or the
 main prompt seed when `reroll_seed=-1`.
 
-`SxCP Camera Control` outputs `camera_config`, which can be connected to the
-prompt builder or the Insta/OF pair node. It makes camera/framing first-class
-instead of relying on a weak phrase inside the prompt.
+`SxCP Camera Control` and `SxCP Camera Orbit Control` output `camera_config`,
+which can be connected to the prompt builder or the Insta/OF pair node. They
+make camera/framing first-class instead of relying on a weak phrase inside the
+prompt.
 
 Camera controls:
 
@@ -201,6 +203,24 @@ Camera controls:
 - `camera_detail`: `off` emits no camera sentence, `compact` emits one short
   camera sentence, and `full` emits the full detailed camera constraint.
 
+`SxCP Camera Orbit Control` is the numeric/directable version inspired by
+multi-angle camera nodes. It maps `horizontal_angle`, `vertical_angle`, and
+`zoom` into a stable prompt such as `135-degree back-right quarter view,
+elevated shot, medium shot`. Use it when the model needs an exact front, side,
+back-quarter, low, high, or overhead style camera anchor. Its first output is
+the same `camera_config` type, so it can replace `SxCP Camera Control` anywhere.
+
+Orbit controls:
+
+- `horizontal_angle`: `0` front, `90` right side, `180` back, `270` left side,
+  with quarter views between them.
+- `vertical_angle`: negative values are low-angle, `0` is eye-level, positive
+  values move toward elevated/high-angle.
+- `zoom`: `0-2` wide, `2-6` medium, `6-10` close unless `framing` overrides it.
+- `subject_focus`: optionally centers face, torso, hips, full body, main action,
+  contact points, or the environment.
+- `include_degrees`: keeps the numeric angle in the emitted camera phrase.
+
 `SxCP Caption Naturalizer` rewrites tag-like captions or labeled prompts into
 more natural language. Connect the prompt builder's `metadata_json` output to
 `source_text` for the cleanest result. You can also connect `caption` or
@@ -306,8 +326,8 @@ pair node. Defaults are set so the softcore prompt is solo while the hardcore
 prompt can include partners. Softcore defaults to handheld selfie framing;
 hardcore defaults to `from_camera_config`, which emits no camera sentence unless
 a camera config is connected or you select an explicit hardcore camera mode.
-For stronger camera control, connect `SxCP Camera Control` to the pair node's
-optional `camera_config` input.
+For stronger camera control, connect `SxCP Camera Control` or
+`SxCP Camera Orbit Control` to the pair node's optional `camera_config` input.
 
 Options:
 
@@ -342,11 +362,12 @@ Options:
   references the softcore outfit, uses it displaced/removed, or makes Woman A
   explicitly nude. It is a fallback for Woman A; `hardcore_clothing` on
   `SxCP Woman Slot` or `SxCP Man Slot` takes priority for that character.
-- `softcore_camera_mode`: base camera mode for the softcore output.
+- `softcore_camera_mode`: `from_camera_config` or a base camera mode for the
+  softcore output. The default is still `handheld_selfie`.
 - `hardcore_camera_mode`: `from_camera_config`, `same_as_softcore`, or a
   separate base camera mode for the hardcore output. `from_camera_config` is
-  neutral with no connected camera config, and uses `SxCP Camera Control` when
-  one is connected.
+  neutral with no connected camera config, and uses `SxCP Camera Control` or
+  `SxCP Camera Orbit Control` when one is connected.
 - `camera_detail`: `off`, `compact`, or `full` for the pair prompt camera text.
 - `hardcore_detail_density`: `compact` keeps the Krea hardcore rewrite mostly
   to the position/action sentence, `balanced` keeps one useful non-duplicated
@@ -376,9 +397,10 @@ The node keeps the original generator controls:
 - `figure`: `curvy`, `balanced`, `bombshell`.
 - In split workflows, use `SxCP Advanced Filters` checkboxes instead of negative
   toggles. Black/African and plus-size are positive include choices there.
-- Optional `camera_config`: connect `SxCP Camera Control` to force selfie,
-  phone, lens, angle, distance, crop, and camera-priority behavior. This applies
-  to custom categories too, including `Hardcore sexual poses`.
+- Optional `camera_config`: connect `SxCP Camera Control` or
+  `SxCP Camera Orbit Control` to force selfie, phone, lens, angle, numeric
+  orbit, crop, and camera-priority behavior. This applies to custom categories
+  too, including `Hardcore sexual poses`.
 
 `auto_weighted` uses the original batch mix: mostly women, then men, couples, and
 group/layout rows. Direct categories generate only that selected category.