Scene Semantic Specs
This directory contains the user-visible meaning of scene objects and visual behavior.
Use these files when changing axes, scales, annotations, legends, visual-family rules, lighting, transparency, clipping, transforms, or geometry utilities.
Files
- VISUAL_FAMILIES.md: visual-family taxonomy.
- VISUAL_CONTRACT.md: shared producer contract for all visuals.
- VISUAL_FAMILY_RULES.md: family boundary rules and anti-patterns.
- COLOR_MANAGEMENT.md: sRGB-authored colors, linear rendering, texture color roles, and output encoding.
- SCALES.md: scale and colormap semantics.
- SAMPLED_FIELD_INTERPRETATION.md: sampled-field format, semantic, colorizer, visual-technique, and query behavior.
- AXES.md: axes, ticks, labels, and domain behavior.
- ANNOTATIONS.md: labels, guides, probes, overlays, and callouts.
- LEGENDS_AND_COLORBARS.md: explanatory mapping objects.
- LIGHTING.md: scene lighting model and ray-tracing forward compatibility.
- TRANSPARENCY.md: alpha modes and transparency planning.
- EFFECTS.md: screen-space outline, edge enhancement, bloom, and effect ordering.
- TEXT.md: text content, placement, resources, and DPI behavior.
- SYMBOLS.md: reusable marker/annotation/vector-head symbol resources.
- CLIPPING.md: clip modes and data-area clipping.
- NONLINEAR_TRANSFORMS.md: non-linear coordinate transforms.
- GEOMETRY_UTILITIES.md: CPU-side geometry utility layer.
Active Proposal Inputs
- ../proposals/promoted/ANNOTATION_MEASUREMENT_DESIGN.md for dimensions/callouts beyond landed label and scale-bar slices
- ../proposals/promoted/AXES_DOMAIN_DESIGN.md for linked-domain and unit rationale beyond landed linear axes
- ../proposals/promoted/COLORBAR_COLORMAP_DESIGN.md
- ../proposals/promoted/GEOM_DESIGN.md
- ../proposals/promoted/MESH_SHADING_DESIGN.md
- ../proposals/future/RAY_TRACING_FORWARD_COMPAT.md
- ../proposals/active/SCIENTIFIC_COORDINATE_NORMALIZATION.md
- ../proposals/promoted/TEXT_DESIGN.md
- ../proposals/promoted/TRANSPARENCY_WBOIT_DESIGN.md