#include "3d_placeholder_utils.h"
#include <footprint.h>
#include <pad.h>
#include <board_item.h>
#include <layer_ids.h>
#include <base_units.h>
#include <geometry/eda_angle.h>
#include <geometry/shape_poly_set.h>
#include <pcb_shape.h>
#include <convert_shape_list_to_polygon.h>
#include <convert_basic_shapes_to_polygon.h>
#include <wx/log.h>

Functions
BOX2I	CalcPlaceholderLocalBox (const FOOTPRINT *aFootprint)
	Calculate a local space bounding box for a placeholder 3D model.

static bool	buildFilledPolygonFromShapes (const FOOTPRINT *aFootprint, PCB_LAYER_ID aLayer, SHAPE_POLY_SET &aOutline)
	Build a filled polygon from shapes on the given layer.

static bool	buildPadBoundingBox (const FOOTPRINT *aFootprint, SHAPE_POLY_SET &aOutline)

bool	GetExtrusionOutline (const FOOTPRINT *aFootprint, SHAPE_POLY_SET &aOutline, PCB_LAYER_ID aLayerOverride)
	Get the extrusion outline polygon for a footprint in board coordinates.

bool	GetExtrusionPinOutline (const FOOTPRINT *aFootprint, SHAPE_POLY_SET &aPinPoly)
	Get the pin outline polygons for extruded THT pin rendering.

EXTRUSION_MATERIAL_PROPS	GetMaterialProps (EXTRUSION_MATERIAL aMaterial, const SFVEC3F &aDiffuse)

void	ApplyExtrusionTransform (SHAPE_POLY_SET &aOutline, const EXTRUDED_3D_BODY *aBody, const VECTOR2I &aFpPos)
	Apply 2D extrusion transforms (rotation, scale, offset) to an outline.

Function Documentation

◆ ApplyExtrusionTransform()

void ApplyExtrusionTransform	(	SHAPE_POLY_SET &	aOutline,
		const EXTRUDED_3D_BODY *	aBody,
		const VECTOR2I &	aFpPos )

Apply 2D extrusion transforms (rotation, scale, offset) to an outline.

Definition at line 384 of file 3d_placeholder_utils.cpp.

References DEGREES_T, EXTRUDED_3D_BODY::m_offset, EXTRUDED_3D_BODY::m_rotation, EXTRUDED_3D_BODY::m_scale, SHAPE_POLY_SET::Move(), pcbIUScale, SHAPE_POLY_SET::Rotate(), SHAPE_POLY_SET::Scale(), VECTOR3< T >::x, VECTOR3< T >::y, and VECTOR3< T >::z.

Referenced by RENDER_3D_RAYTRACE_BASE::addExtrudedBodyToRaytracer(), STEP_PCB_MODEL::AddExtrudedPins(), EXPORTER_STEP::buildFootprint3DShapes(), and RENDER_3D_OPENGL::renderExtrudedBodies().

◆ buildFilledPolygonFromShapes()

static bool buildFilledPolygonFromShapes	(	const FOOTPRINT *	aFootprint,
		PCB_LAYER_ID	aLayer,
		SHAPE_POLY_SET &	aOutline )

static

Build a filled polygon from shapes on the given layer.

Separates shapes into self-closed and open shapes. Self-closed shapes are converted to filled polygons. Open shapes are chained into closed contours.

Definition at line 131 of file 3d_placeholder_utils.cpp.

References SHAPE_POLY_SET::AddOutline(), SHAPE_POLY_SET::Append(), ARC_HIGH_DEF, CIRCLE, ConvertOutlineToPolygon(), SHAPE_POLY_SET::COutline(), ERROR_INSIDE, EDA_SHAPE::GetShape(), FOOTPRINT::GraphicalItems(), SHAPE_POLY_SET::NewOutline(), SHAPE_POLY_SET::OutlineCount(), PCB_SHAPE_T, pcbIUScale, POLY, RECTANGLE, SHAPE_POLY_SET::RemoveAllContours(), SHAPE_POLY_SET::Simplify(), and TransformCircleToPolygon().

Referenced by GetExtrusionOutline().

◆ buildPadBoundingBox()

static bool buildPadBoundingBox	(	const FOOTPRINT *	aFootprint,
		SHAPE_POLY_SET &	aOutline )

static

Definition at line 233 of file 3d_placeholder_utils.cpp.

References SHAPE_POLY_SET::Append(), CalcPlaceholderLocalBox(), BOX2< Vec >::GetBottom(), BOX2< Vec >::GetHeight(), BOX2< Vec >::GetLeft(), FOOTPRINT::GetOrientation(), BOX2< Vec >::GetOrigin(), FOOTPRINT::GetPosition(), BOX2< Vec >::GetRight(), BOX2< Vec >::GetTop(), BOX2< Vec >::GetWidth(), SHAPE_POLY_SET::NewOutline(), and RotatePoint().

Referenced by GetExtrusionOutline().

◆ CalcPlaceholderLocalBox()

BOX2I CalcPlaceholderLocalBox ( const FOOTPRINT * aFootprint )

Calculate a local space bounding box for a placeholder 3D model.

Attempts pads first, then graphical items on fab/courtyard/silk layers, then falls back to the footprint bounding box.

Definition at line 38 of file 3d_placeholder_utils.cpp.

References PADSTACK::ALL_LAYERS, B_CrtYd, B_Fab, B_SilkS, F_CrtYd, F_Fab, F_SilkS, BOX2< Vec >::GetBottom(), FOOTPRINT::GetBoundingBox(), BOX2< Vec >::GetHeight(), BOX2< Vec >::GetLeft(), FOOTPRINT::GetOrientation(), BOX2< Vec >::GetOrigin(), FOOTPRINT::GetPosition(), BOX2< Vec >::GetRight(), BOX2< Vec >::GetTop(), BOX2< Vec >::GetWidth(), FOOTPRINT::GraphicalItems(), BOX2< Vec >::Merge(), pad, FOOTPRINT::Pads(), RotatePoint(), BOX2< Vec >::SetOrigin(), and BOX2< Vec >::SetSize().

Referenced by RENDER_3D_RAYTRACE_BASE::addPlaceholderToRaytracer(), buildPadBoundingBox(), and RENDER_3D_OPENGL::renderPlaceholderForFootprint().

◆ GetExtrusionOutline()

bool GetExtrusionOutline	(	const FOOTPRINT *	aFootprint,
		SHAPE_POLY_SET &	aOutline,
		PCB_LAYER_ID	aLayerOverride = UNDEFINED_LAYER )

Get the extrusion outline polygon for a footprint in board coordinates.

Parameters

aFootprint	the footprint to extract an outline from.
aOutline	output polygon set.
aLayerOverride	when not UNDEFINED_LAYER, use this layer instead of the footprint's extruded body layer setting.