## /vis/scene/add/

Add model to current scene.

## Sub-directories :

## Commands :

axes [x0] [y0] [z0] [length] [unit]

  Add axes.
  Draws axes at (x0, y0, z0) of given length.

  Available at all Geant4 states.

  Parameters

  x0 | type d | Omittable : default value = 0 |
  y0 | type d | Omittable : default value = 0 |
  z0 | type d | Omittable : default value = 0 |
  length | type d | Omittable : default value = 1 |
  unit | type s | Omittable : default value = m |

eventID [size] [x-position] [y-position]

  Adds eventID to current scene.
  Run and event numbers are drawn at end of event or run when the scene in which they are added is current.

  Available at all Geant4 states.

  Parameters

  size | type i | Omittable : default value = 18 |
  x-position | type d | Omittable : default value = -0.95 |
  y-position | type d | Omittable : default value = 0.9 |

ghosts [particle]

  Adds ghost volumes (G4FlavoredParallelWorld) to the current scene.
  Selects by particle.

  Available at all Geant4 states.

  Parameters

  particle | type s | Omittable : default value = all |

hits

  Adds hits to current scene.
  Hits are drawn at end of event when the scene in which they are added is current.

  Available at all Geant4 states.

logicalVolume [logical-volume-name] [depth-of-descent] [booleans-flag] [voxels-flag] [readout-flag]

  Adds a logical volume to the current scene,
  Shows boolean components (if any), voxels (if any) and readout geometry (if any). Note: voxels are not constructed until start of run - "/run/beamOn".

  Available at all Geant4 states.

  Parameters

  logical-volume-name | type s |  |
  depth-of-descent | type i | Omittable : default value = 1 |
  booleans-flag | type b | Omittable : default value = 1 |
  voxels-flag | type b | Omittable : default value = 1 |
  readout-flag | type b | Omittable : default value = 1 |

logo [height] [unit] [direction] [red] [green] [blue] [auto|manual] [xmid] [ymid] [zmid] [unit]

  Adds a G4 logo to the current scene.
  The placement, if automatic, is similar to that of scale - "help /vis/scene/add/scale" for more information.

  Available at all Geant4 states.

  Parameters

  height | type d | Omittable : default value = 1 |
  unit | type s | Omittable : default value = m |
  direction | type s | Omittable : default value = x |
  red | type d | Omittable : default value = 0 |
  green | type d | Omittable : default value = 1 |
  blue | type d | Omittable : default value = 0 |
  auto|manual | type s | Omittable : default value = auto | Parameter candidates : auto manual
  xmid | type d | Omittable : default value = 0 |
  ymid | type d | Omittable : default value = 0 |
  zmid | type d | Omittable : default value = 0 |
  unit | type s | Omittable : default value = m |

scale [length] [unit] [direction] [red] [green] [blue] [auto|manual] [xmid] [ymid] [zmid] [unit]

  Adds an annotated scale line to the current scene.
  An annotated line in the specified direction with tick marks at the end. If autoPlacing is true it is required to be centred at the front, right, bottom corner of the world space, comfortably outside the existing bounding box/sphere so that existing objects do not obscure it. Otherwise it is required to be drawn with mid-point at (xmid, ymid, zmid). The auto placing algorithm might be: x = xmin + (1 + comfort) * (xmax - xmin); y = ymin - comfort * (ymax - ymin); z = zmin + (1 + comfort) * (zmax - zmin); if direction == x then (x - length,y,z) to (x,y,z); if direction == y then (x,y,z) to (x,y + length,z); if direction == z then (x,y,z - length) to (x,y,z);

  Available at all Geant4 states.

  Parameters

  length | type d | Omittable : default value = 1 |
  unit | type s | Omittable : default value = m |
  direction | type s | Omittable : default value = x |
  red | type d | Omittable : default value = 1 |
  green | type d | Omittable : default value = 0 |
  blue | type d | Omittable : default value = 0 |
  auto|manual | type s | Omittable : default value = auto | Parameter candidates : auto manual
  xmid | type d | Omittable : default value = 0 |
  ymid | type d | Omittable : default value = 0 |
  zmid | type d | Omittable : default value = 0 |
  unit | type s | Omittable : default value = m |

text [x] [y] [z] [unit] [font_size] [x_offset] [y_offset] [text]

  Adds text to current scene.

  Available at all Geant4 states.

  Parameters

  x | type d | Omittable : default value = 0 |
  y | type d | Omittable : default value = 0 |
  z | type d | Omittable : default value = 0 |
  unit | type s | Omittable : default value = m |
  font_size | type d | Omittable : default value = 12 |
  x_offset | type d | Omittable : default value = 0 |
  y_offset | type d | Omittable : default value = 0 |
  text | type s | Omittable : default value = Hello G4 |

trajectories [default-trajectory-type]

  Adds trajectories to current scene.
  Causes trajectories, if any, to be drawn at the end of processing an event. Switches on trajectory storing and sets the default trajectory type.
  The command line parameter list determines the default trajectory type. If it contains the string "smooth", auxiliary inter-step points will be inserted to improve the smoothness of the drawing of a curved trajectory. If it contains the string "rich", significant extra information will be stored in the trajectory (G4RichTrajectory) amenable to modeling and filtering with "/vis/modeling/trajectories/create/drawByAttribute" and "/vis/filtering/trajectories/create/attributeFilter" commands. It may contain both strings in any order.
  To switch off trajectory storing: "/tracking/storeTrajectory 0". See also "/vis/scene/endOfEventAction".
  Note: This only sets the default. Independently of the result of this command, a user may instantiate a trajectory that overrides this default in PreUserTrackingAction.

  Available at all Geant4 states.

  Parameters

  default-trajectory-type | type s | Omittable : default value = |

userAction [xmin] [xmax] [ymin] [ymax] [zmin] [zmax] [unit]

  Add Vis User Action, if any, to current scene.
  Optional arguments define the extent of the callback drawing. You may not need this if the extent has been defined in the original SetUserAction or is defined by other components of the scene. But if the user action is the only component of the scene, you will certainly need to set the extent either in SetUserAction or here. A scene must have an extent one way or another so that the viewer can calculate how to point the camera.

  Available at all Geant4 states.

  Parameters

  xmin | type d | Omittable : default value = 0 |
  xmax | type d | Omittable : default value = 0 |
  ymin | type d | Omittable : default value = 0 |
  ymax | type d | Omittable : default value = 0 |
  zmin | type d | Omittable : default value = 0 |
  zmax | type d | Omittable : default value = 0 |
  unit | type s | Omittable : default value = cm |

volume [physical-volume-name] [copy-no] [depth-of-descent] [clip-volume-type] [parameter-unit] [parameter-1] [parameter-2] [parameter-3] [parameter-4] [parameter-5] [parameter-6]

  Adds a physical volume to current scene, with optional clipping volume.
  If physical-volume-name is "world" (the default), the top of the main geometry tree (material world) is added. If "worlds", the top of all worlds - material world and parallel worlds, if any - are added. Otherwise a search of all worlds is made, taking the first matching occurence only. To see a representation of the geometry hierarchy of the worlds, try "/vis/drawTree [worlds]" or one of the driver/browser combinations that have the required functionality, e.g., HepRepFile/XML with the WIRED3/4 browser.
  If clip-volume-type is specified, the subsequent parameters are used to to define a clipping volume. For example, "vis/scene/add/volume ! ! ! -box km 0 1 0 1 0 1" will draw the world with the positive octant cut away.
  If clip-volume-type is prepended with '-', the clip-volume is subtracted (cutaway). (This is the default if there is no prepended character.) If '*' is prepended, the intersection of the physical-volume and the clip-volume is made. (You can make a section/DCUT with a thin box, for example).
  For "box", the parameters are xmin,xmax,ymin,ymax,zmin,zmax. Only "box" is programmed at present.

  Available at all Geant4 states.

  Parameters

  physical-volume-name | type s | Omittable : default value = world |
  copy-no | type i | Omittable : default value = -1 |
  depth-of-descent | type i | Omittable : default value = -1 |
  clip-volume-type | type s | Omittable : default value = none | Parameter candidates : none box -box *box
  parameter-unit | type s | Omittable : default value = m |
  parameter-1 | type d | Omittable : default value = 0 |
  parameter-2 | type d | Omittable : default value = 0 |
  parameter-3 | type d | Omittable : default value = 0 |
  parameter-4 | type d | Omittable : default value = 0 |
  parameter-5 | type d | Omittable : default value = 0 |
  parameter-6 | type d | Omittable : default value = 0 |