add_surface_pt#
- ptrace.add_surface_pt(p0: float, p1: float) int #
Adds emitters (and thus more traces) to the current surface restricted particle trace part(s) from a screen point pick location.
The “ptrace: surface_restricted” command must be ON prior to this command. Any existing surface restricted particle trace part can have emitters added to them. These trace parts must be selected before the addition.- Args:
- p0:
‘screen_x’ screen x coordinate (0.0 to 1.0)
- p1:
‘screen_y’ screen y coordinate (0.0 to 1.0)
- Examples:
# # Getting the cursor to the desired location # ensight.view_transf.cursor(-0.927830,1.474020,0.000000) # # Selecting the parent part(s) # ensight.part.select_begin(1) # # Setting some attributes before creation # (surface_restricted must be on) # ensight.ptrace.begin() ensight.ptrace.surface_restricted("ON") ensight.ptrace.variable("VITESSE") ensight.ptrace.type("streamline") ensight.ptrace.component(1.0000e+00,1.0000e+00,1.0000e+00) ensight.ptrace.representation("line") ensight.ptrace.emit_at_current_time("ON") ensight.ptrace.end() # # Creating surface restricted trace from a # screen location (becomes part 2) # ensight.ptrace.create_surface_pt(0.148551,0.484398) # # Selecting the particle trace part to add to # and adding a couple of new emitters from which # more traces are made # ensight.part.select_begin(2) ensight.ptrace.add_surface_pt(0.136473,0.646360) ensight.ptrace.add_surface_pt(0.193237,0.546805)
- Returns:
zero on success, non-zero on error