display_offset

ptrace.display_offset(p0: float) → int

Sets the distance normal to the surface at which the surface restricted trace will be displayed. This can be used to avoid z-buffer display problems that arise because the trace lies in the same plane as the surface.

A positive number moves the trace in the direction of the positive surface normal, while a negative number moves in the opposite direction.

Args:

p0:

‘offset_distance’ the distance normal to the surface at which to display the trace

Examples:

#
# Selecting the parent part
#
ensight.part.select_begin(1)
#
# Setting some attributes before creation
# (the  display_offset for the surface restricted trace
#  is being set here)
#
ensight.ptrace.begin()
ensight.part.description("Particle trace part")
ensight.ptrace.surface_restricted("ON")
ensight.ptrace.variable_offset(1.0000e-01)
ensight.ptrace.display_offset(-0.5000e+00)
ensight.ptrace.total_time(2.0000e+02)
ensight.ptrace.emit_at_current_time("ON")
ensight.ptrace.end()
#
# Creating trace from a point
#
ensight.ptrace.create_pt()

Returns:

zero on success, non-zero on error