#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	GetExtrusionPinOutlines (const FOOTPRINT *aFootprint, SHAPE_POLY_SET &aPinPoly, SHAPE_POLY_SET &aPegPoly)
	Get the hole outline polygons for extruded 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 391 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(), IDF_EXPORTER::createOutlineFromExtrudedBody(), PANEL_FP_PROPERTIES_3D_MODEL::OnExportExtrudedModel(), 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 132 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 234 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 34 of file 3d_placeholder_utils.cpp.

References 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.

Returns: true if outline was found.

Definition at line 261 of file 3d_placeholder_utils.cpp.

References SHAPE_POLY_SET::Append(), B_CrtYd, B_Fab, B_SilkS, buildFilledPolygonFromShapes(), buildPadBoundingBox(), F_CrtYd, F_Fab, F_SilkS, FlipLayer(), FOOTPRINT::GetCourtyard(), FOOTPRINT::GetExtrudedBody(), FOOTPRINT::GetReference(), FOOTPRINT::IsFlipped(), EXTRUDED_3D_BODY::m_layer, SHAPE_POLY_SET::OutlineCount(), SHAPE_POLY_SET::RemoveAllContours(), SHAPE_POLY_SET::Simplify(), UNDEFINED_LAYER, and UNSELECTED_LAYER.

Referenced by RENDER_3D_RAYTRACE_BASE::addExtrudedBodyToRaytracer(), EXPORTER_STEP::buildFootprint3DShapes(), IDF_EXPORTER::createOutlineFromExtrudedBody(), PANEL_FP_PROPERTIES_3D_MODEL::OnExportExtrudedModel(), and RENDER_3D_OPENGL::renderExtrudedBodies().

◆ GetExtrusionPinOutlines()

bool GetExtrusionPinOutlines	(	const FOOTPRINT *	aFootprint,
		SHAPE_POLY_SET &	aPinPoly,
		SHAPE_POLY_SET &	aPegPoly )

Get the hole outline polygons for extruded pin rendering.

Collects drill hole shapes from all pads with holes, shrunk to ~90% of the drill diameter so pins sit inside the hole. Plated holes go to aPinPoly and NPTH holes go to aPegPoly.

Returns: true if at least one hole polygon was generated.

Definition at line 349 of file 3d_placeholder_utils.cpp.

References ARC_HIGH_DEF, ERROR_INSIDE, NPTH, SHAPE_POLY_SET::OutlineCount(), pad, FOOTPRINT::Pads(), SHAPE_POLY_SET::RemoveAllContours(), and SHAPE_POLY_SET::Simplify().

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

◆ GetMaterialProps()

EXTRUSION_MATERIAL_PROPS GetMaterialProps	(	EXTRUSION_MATERIAL	aMaterial,
		const SFVEC3F &	aDiffuse )

Definition at line 376 of file 3d_placeholder_utils.cpp.

References COPPER, MATTE, METAL, and PLASTIC.

Referenced by RENDER_3D_RAYTRACE_BASE::addExtrudedBodyToRaytracer(), and RENDER_3D_OPENGL::renderExtrudedBodies().

Functions