What’s New
Getting Started

Primitives

Last Updated: November 8, 20241.2 min read

Overview

In Sceneri, a primitive 3D component refers to basic geometric shapes that can be easily created and manipulated in a 3D space. These primitives serve as foundational elements for building more complex objects and environments in your game. Sceneri provides several built-in primitive 3D shapes, which you can use directly in your scenes.

Component Types

Icon

Description

  • Arc

    The arc is a quarter of a cylinder with the center hollow similar to the torus but hardened. With the arc component you can create unique obstacles with the rotation component and prototype pendulums.

  • Arrow

    The arrow is a simple composite of both of the cone and cylinder meshes. With the arrow component you can debug direction of objects or create directional indicators in your scenes.

  • Box

    This is a simple cube with sides one unit long, textured so that the image is repeated on each of the six faces. As it stands, a cube isn’t really a very common object in most games but when scaled, it is very useful for walls, posts, boxes, steps and other similar items.

  • Capsule

    A capsule is a cylinder with hemispherical caps at the ends. The object is one unit in diameter and two units high (the body is one unit and the two caps are half a unit each). It is textured so that the image wraps around exactly once, pinched at each hemisphere’s apex.

  • Cone

    The Cone Component is a a geometric shape that resembles a cone deriving from a pyramid, which can be used for various purposes, such as visual representation, collision detection, or physics interactions.

  • Cylinder

    This is a simple cylinder which is two units high and one unit in diameter, textured so that the image wraps once around the tube shape of the body but also appears separately in the two flat, circular ends.

  • Plane

    The quad primitive resembles the plane but its edges are only one unit long and the surface is oriented in the XY plane of the local coordinate space. Also, a quad is divided into just two triangles whereas the plane contains two hundred.

  • Pyramid

    The pyramid primitive is a four-sided shape with a square base and a single apex point above the base. Pyramids can represent hills, buildings, or monuments in your game world, helping to block player movement or create visual interest.

  • Sphere

    This is a sphere of unit diameter (ie, 0.5 unit radius), textured so that the entire image wraps around once with the top and bottom “pinched” at the poles. Spheres are obviously useful for representing balls, planets and projectiles.

  • Torus

    The torus primitive is a donut-shaped object characterized by a circular ring that curves around a central void. In gameplay, a torus can be utilized as a race track for a futuristic hovercraft game, where players navigate around the ring-shaped course.

Features of Primitive 3D Components:

  • Easy to Create: You can create these shapes from the Add Component menu (Viewport > Add Components > [Primitive Type]) without needing to model them in a 3D software package.
  • Transformations: You can easily manipulate these objects in terms of position, rotation, and scale using Sceneri’s gizmo.
  • Materials and Textures: You can assign materials to these primitives to give them different colors, textures, and visual effects.
  • Colliders: Each primitive automatically includes a collider (like BoxCollider for cubes) that allows for collision detection with other objects.
  • Lightweight: Since they are simple shapes, they are efficient to render and suitable for prototyping or as placeholders while developing.

Use Cases:

  • Prototyping: Quickly building levels or testing mechanics without worrying about detailed models.
  • Environment Design: Creating basic structures or natural elements in your game world.
  • Gameplay Elements: Using primitives for interactive objects, like buttons or collectible items.

Conclusion:

Primitive 3D components are fundamental tools in Sceneri that allow developers to quickly and easily construct 3D environments and gameplay elements. They are especially useful during the early stages of game development for prototyping and iteration.

Feedback

Please be sure to submit issues or feature requests through the embedded feedback form. In the event it is a major issue please contact us directly through Discord.