[ Prev | Index | Next ]
Japanese English

Spinning a Coordinate System

This section covers how to spin coordinate systems. Here, "spinning" refers to rotations based on the axes of the coordinate system itself, rather than those of its parent system.

Note: The term "spinning a coordinate system" is a VCSSL-specific concept and is not commonly used in standard 3DCG terminology.

Spinning a Coordinate System

Spinning Around Each Axis

To spin a coordinate system around its own X, Y, or Z axis, use the spinCoordinateX(...), spinCoordinateY(...), and spinCoordinateZ(...) functions:

- Function Format -

void spinCoordinateX ( int coordinateID, float angle )
void spinCoordinateY ( int coordinateID, float angle )
void spinCoordinateZ ( int coordinateID, float angle )

These three functions handle rotation around the local X, Y, and Z axes, respectively.

Arguments:

  • coordinateID: The ID of the coordinate system to modify.
  • angle: The angle of rotation in radians. Positive values rotate in the direction a right-hand screw would move along the axis.

What is a radian?
A radian is a unit of angular measure commonly used in science and engineering. In this unit system, 180 degrees is equivalent to π radians. For example, 90 degrees = π/2 radians, and 45 degrees = π/4 radians.
Degrees and Radians
Degrees and Radians
180 degrees is equivalent to π radians.
In VCSSL, the constant PI is provided in the Math library as a predefined float-type value.

Spinning Around an Arbitrary Direction Vector

To spin a coordinate system around an axis defined by a direction vector (relative to itself), use the spinCoordinate(...) function:

- Function Format -

void spinCoordinate (
  int coordinateID,
  float angle,
  float vx, float vy, float vz
)

Arguments:

  • coordinateID: The ID of the coordinate system to spin.
  • angle: The angle of rotation in radians (right-hand rule applies).
  • vx, vy, vz: The direction vector components of the spin axis (relative to the coordinate system itself).

Spinning Around a Vector with an Arbitrary Origin and Direction

To spin a coordinate system around an axis that has both an arbitrary origin and direction (from the perspective of the coordinate system itself), use an extended form of spinCoordinate(...):

- Function Format -

void spinCoordinate (
  int coordinateID,
  float angle,
  float vx, float vy, float vz,
  float px, float py, float pz
)

Arguments:

  • coordinateID: The ID of the coordinate system to spin.
  • angle: The angle of rotation in radians (right-hand rule applies).
  • vx, vy, vz: The direction vector components of the spin axis.
  • px, py, pz: The position vector components for the axis point of origin (relative to the coordinate system).

Example Program

Let's place a local coordinate system on top of the world coordinate system and spin it 45 degrees (π/4 radians) around its own Z axis.

To help visualize the result, a small axis model will be mounted on the local system, and a large one on the world system. To make the difference between spinning and rotating clearer, we'll move the local coordinate system slightly in the X direction before spinning it.


import graphics3d.Graphics3DFramework;
import Graphics3D;
import Math;  // For the PI constant

// Function called at the start of the program
void onStart ( int rendererID ) {

	// Optional screen size and background color settings
	setWindowSize( 800, 600 );
	setBackgroundColor( 0, 0, 0, 255 );


	// Create a local coordinate system
	int coord = newCoordinate( );

	// Mount it on the world coordinate system
	mountCoordinate( coord, rendererID );

	// Move the local system slightly in the X direction
	moveCoordinate( coord, 1.0, 0.0, 0.0 );


	// Spin the local system 45 degrees around its own Z axis
	spinCoordinateZ( coord, PI/4.0 );


	// Mount a small axis model on the local system
	int axis1 = newAxisModel( 1.5, 1.5, 1.5 );
	mountModel( axis1, rendererID, coord );

	// Mount a large axis model on the world system
	int axis2 = newAxisModel( 3.0, 3.0, 3.0 );
	mountModel( axis2, rendererID );
}
Sample.vcssl

When this program is executed, a black screen will display two axis models. The larger one is mounted on the world coordinate system, and the smaller one is on the local system. The local coordinate system is moved 1.0 unit along the parent's X axis, and then spun 45 degrees around its own Z axis.

Execution Result
Execution Result
A large and a small axis model appear. The small coordinate system has been spun around its own Z axis.



Sponsored Link



Japanese English
Index
[ Prev | Index | Next ]
News From RINEARN
* VCSSL is developed by RINEARN.

English Documentation for Our Software and VCSSL Is Now Nearly Complete
2025-06-30 - We're happy to announce that the large-scale expansion of our English documentation with the support of AI — a project that began two years ago — has now reached its initial target milestone.

VCSSL 3.4.52 Released: Enhanced Integration with External Programs and More
2025-05-25 - This update introduces enhancements to the external program integration features (e.g., for running C-language executables). Several other improvements and fixes are also included. Details inside.

Released: Latest Version of VCSSL with Fixes for Behavioral Changes on Java 24
2025-04-22 - VCSSL 3.4.50 released with a fix for a subtle behavioral change in absolute path resolution on network drives, introduced in Java 24. Details inside.

Released the Latest Versions of RINEARN Graph and VCSSL - Now Supporting Customizable Tick Positions and Labels!
2024-11-24 - Starting with this update, a new "MANUAL" tick mode is now supported, allowing users to freely specify the positions and labels of ticks on the graph. We'll explain the details and how to use it.

Released Exevalator 2.2: Now Compatible with TypeScript and Usable in Web Browsers
2024-10-22 - The open-source expression evaluation library, Exevalator, has been updated to version 2.2. It now supports TypeScript and can be used for evaluating expressions directly in web browsers. Explains the details.

Behind the Scenes of Creating an Assistant AI (Part 1: Fundamental Knowledge)
2024-10-07 - The first part of a series on how to create an Assistant AI. In this article, we introduce the essential knowledge you need to grasp before building an Assistant AI. What exactly is an LLM-based AI? What is RAG? And more.

Launching an Assistant AI to Support Software Usage!
2024-09-20 - We've launched an Assistant AI that answers questions about how to use RINEARN software and helps with certain tasks. Anyone with a ChatGPT account can use it for free. We'll explain how to use it.

Software Updates: Command Expansion in RINEARN Graph, and English Support in VCSSL
2024-02-05 - We updated our apps. This updates include "Enhancing the Command-Line Features of RINEARN Graph" and "Adding English Support to VCSSL." Dives into each of them!