/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2015-2016 Mario Luzeiro * Copyright (C) 1992-2022 KiCad Developers, see AUTHORS.txt for contributors. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ /** * @file create_graphic_brd_items.cpp * @brief This file implements the creation of 2D graphic primitives of pcb items: * pads, tracks, drawsegments, texts.... * It is based on the function found in the files: * board_items_to_polygon_shape_transform.cpp */ #include "../3d_rendering/raytracing/shapes2D/ring_2d.h" #include "../3d_rendering/raytracing/shapes2D/filled_circle_2d.h" #include "../3d_rendering/raytracing/shapes2D/round_segment_2d.h" #include "../3d_rendering/raytracing/shapes2D/triangle_2d.h" #include "fp_textbox.h" #include #include #include #include #include #include #include // for PCB_RENDER_SETTINGS #include #include #include #include #include #include #include #include #include #include #include #include #include #include #define TO_3DU( x ) ( ( x ) * m_biuTo3Dunits ) #define TO_SFVEC2F( vec ) SFVEC2F( TO_3DU( vec.x ), TO_3DU( -vec.y ) ) void BOARD_ADAPTER::addText( const EDA_TEXT* aText, CONTAINER_2D_BASE* aContainer, const BOARD_ITEM* aOwner ) { KIGFX::GAL_DISPLAY_OPTIONS empty_opts; KIFONT::FONT* font = aText->GetDrawFont(); float penWidth = TO_3DU( aText->GetEffectiveTextPenWidth() ); CALLBACK_GAL callback_gal( empty_opts, // Stroke callback [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2 ) { const SFVEC2F pt1_3DU = TO_SFVEC2F( aPt1 ); const SFVEC2F pt2_3DU = TO_SFVEC2F( aPt2 ); if( Is_segment_a_circle( pt1_3DU, pt2_3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( pt1_3DU, penWidth / 2, *aOwner ) ); else aContainer->Add( new ROUND_SEGMENT_2D( pt1_3DU, pt2_3DU, penWidth, *aOwner ) ); }, // Triangulation callback [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2, const VECTOR2I& aPt3 ) { aContainer->Add( new TRIANGLE_2D( TO_SFVEC2F( aPt1 ), TO_SFVEC2F( aPt2 ), TO_SFVEC2F( aPt3 ), *aOwner ) ); } ); TEXT_ATTRIBUTES attrs = aText->GetAttributes(); attrs.m_Angle = aText->GetDrawRotation(); font->Draw( &callback_gal, aText->GetShownText(), aText->GetDrawPos(), attrs ); } void BOARD_ADAPTER::addShape( const PCB_DIMENSION_BASE* aDimension, CONTAINER_2D_BASE* aContainer, const BOARD_ITEM* aOwner ) { addText( &aDimension->Text(), aContainer, aDimension ); const int linewidth = aDimension->GetLineThickness(); for( const std::shared_ptr& shape : aDimension->GetShapes() ) { switch( shape->Type() ) { case SH_SEGMENT: { const SEG& seg = static_cast( shape.get() )->GetSeg(); aContainer->Add( new ROUND_SEGMENT_2D( TO_SFVEC2F( seg.A ), TO_SFVEC2F( seg.B ), TO_3DU( linewidth ), *aOwner ) ); break; } case SH_CIRCLE: { int radius = static_cast( shape.get() )->GetRadius(); int delta = aDimension->GetLineThickness() / 2; aContainer->Add( new RING_2D( TO_SFVEC2F( shape->Centre() ), TO_3DU( radius - delta ), TO_3DU( radius + delta ), *aOwner ) ); break; } default: break; } } } void BOARD_ADAPTER::addFootprintShapes( const FOOTPRINT* aFootprint, CONTAINER_2D_BASE* aContainer, PCB_LAYER_ID aLayerId ) { KIGFX::GAL_DISPLAY_OPTIONS empty_opts; if( aFootprint->Reference().GetLayer() == aLayerId && aFootprint->Reference().IsVisible() ) addText( &aFootprint->Reference(), aContainer, &aFootprint->Reference() ); if( aFootprint->Value().GetLayer() == aLayerId && aFootprint->Value().IsVisible() ) addText( &aFootprint->Value(), aContainer, &aFootprint->Value() ); for( BOARD_ITEM* item : aFootprint->GraphicalItems() ) { switch( item->Type() ) { case PCB_FP_TEXT_T: { FP_TEXT* text = static_cast( item ); if( text->GetLayer() == aLayerId && text->IsVisible() ) addText( text, aContainer, text ); break; } case PCB_FP_TEXTBOX_T: { FP_TEXTBOX* textbox = static_cast( item ); if( textbox->GetLayer() == aLayerId ) { addShape( textbox, aContainer, aFootprint ); addText( textbox, aContainer, aFootprint ); } break; } case PCB_FP_DIM_ALIGNED_T: case PCB_FP_DIM_CENTER_T: case PCB_FP_DIM_ORTHOGONAL_T: case PCB_FP_DIM_RADIAL_T: case PCB_FP_DIM_LEADER_T: { PCB_DIMENSION_BASE* dimension = static_cast( item ); if( dimension->GetLayer() == aLayerId ) addShape( dimension, aContainer, aFootprint ); break; } case PCB_FP_SHAPE_T: { FP_SHAPE* shape = static_cast( item ); if( shape->GetLayer() == aLayerId ) addShape( shape, aContainer, aFootprint ); break; } default: break; } } } void BOARD_ADAPTER::createTrack( const PCB_TRACK* aTrack, CONTAINER_2D_BASE* aDstContainer ) { SFVEC2F start3DU = TO_SFVEC2F( aTrack->GetStart() ); SFVEC2F end3DU = TO_SFVEC2F( aTrack->GetEnd() ); switch( aTrack->Type() ) { case PCB_VIA_T: { const float radius3DU = TO_3DU( aTrack->GetWidth() / 2 ); aDstContainer->Add( new FILLED_CIRCLE_2D( start3DU, radius3DU, *aTrack ) ); break; } case PCB_ARC_T: { const PCB_ARC* arc = static_cast( aTrack ); VECTOR2D center( arc->GetCenter() ); EDA_ANGLE arc_angle = arc->GetAngle(); double radius = arc->GetRadius(); int arcsegcount = GetArcToSegmentCount( radius, ARC_HIGH_DEF, arc_angle ); int circlesegcount; // We need a circle to segment count. However, the arc angle can be small, and the // radius very big. so we calculate a reasonable value for circlesegcount. if( arcsegcount <= 1 ) // The arc will be approximated by a segment { circlesegcount = 1; } else { circlesegcount = KiROUND( arcsegcount * 360.0 / std::abs( arc_angle.AsDegrees() ) ); circlesegcount = std::max( 1, std::min( circlesegcount, 128 ) ); } transformArcToSegments( VECTOR2I( center.x, center.y ), arc->GetStart(), arc_angle, circlesegcount, arc->GetWidth(), aDstContainer, *arc ); break; } case PCB_TRACE_T: // Track is a usual straight segment { // Cannot add segments that have the same start and end point if( Is_segment_a_circle( start3DU, end3DU ) ) { aDstContainer->Add( new FILLED_CIRCLE_2D( start3DU, TO_3DU( aTrack->GetWidth() / 2 ), *aTrack ) ); } else { aDstContainer->Add( new ROUND_SEGMENT_2D( start3DU, end3DU, TO_3DU( aTrack->GetWidth() ), *aTrack ) ); } break; } default: break; } } void BOARD_ADAPTER::createPadWithMargin( const PAD* aPad, CONTAINER_2D_BASE* aContainer, PCB_LAYER_ID aLayer, const VECTOR2I& aMargin ) const { SHAPE_POLY_SET poly; int maxError = GetBoard()->GetDesignSettings().m_MaxError; VECTOR2I clearance = aMargin; // Our shape-based builder can't handle negative or differing x:y clearance values (the // former are common for solder paste while the later get generated when a relative paste // margin is used with an oblong pad). So we apply this huge hack and fake a larger pad to // run the general-purpose polygon builder on. // Of course being a hack it falls down when dealing with custom shape pads (where the size // is only the size of the anchor), so for those we punt and just use aMargin.x. if( ( clearance.x < 0 || clearance.x != clearance.y ) && aPad->GetShape() != PAD_SHAPE::CUSTOM ) { VECTOR2I dummySize = VECTOR2I( aPad->GetSize() ) + clearance + clearance; if( dummySize.x <= 0 || dummySize.y <= 0 ) return; PAD dummy( *aPad ); dummy.SetSize( wxSize( dummySize.x, dummySize.y ) ); dummy.TransformShapeWithClearanceToPolygon( poly, aLayer, 0, maxError, ERROR_INSIDE ); clearance = { 0, 0 }; } else { auto padShapes = std::static_pointer_cast( aPad->GetEffectiveShape() ); for( const SHAPE* shape : padShapes->Shapes() ) { switch( shape->Type() ) { case SH_SEGMENT: { const SHAPE_SEGMENT* seg = static_cast( shape ); const SFVEC2F a3DU = TO_SFVEC2F( seg->GetSeg().A ); const SFVEC2F b3DU = TO_SFVEC2F( seg->GetSeg().B ); const double width3DU = TO_3DU( seg->GetWidth() + clearance.x * 2 ); // Cannot add segments that have the same start and end point if( Is_segment_a_circle( a3DU, b3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( a3DU, width3DU / 2, *aPad ) ); else aContainer->Add( new ROUND_SEGMENT_2D( a3DU, b3DU, width3DU, *aPad ) ); } break; case SH_CIRCLE: { const SHAPE_CIRCLE* circle = static_cast( shape ); const double radius3DU = TO_3DU( circle->GetRadius() + clearance.x ); const SFVEC2F center3DU = TO_SFVEC2F( circle->GetCenter() ); aContainer->Add( new FILLED_CIRCLE_2D( center3DU, radius3DU, *aPad ) ); } break; case SH_RECT: { const SHAPE_RECT* rect = static_cast( shape ); poly.NewOutline(); poly.Append( rect->GetPosition() ); poly.Append( rect->GetPosition().x + rect->GetSize().x, rect->GetPosition().y ); poly.Append( rect->GetPosition() + rect->GetSize() ); poly.Append( rect->GetPosition().x, rect->GetPosition().y + rect->GetSize().y ); } break; case SH_SIMPLE: poly.AddOutline( static_cast( shape )->Vertices() ); break; case SH_POLY_SET: poly = *(SHAPE_POLY_SET*) shape; break; case SH_ARC: { const SHAPE_ARC* arc = static_cast( shape ); SHAPE_LINE_CHAIN l = arc->ConvertToPolyline( maxError ); for( int i = 0; i < l.SegmentCount(); i++ ) { SHAPE_SEGMENT seg( l.Segment( i ).A, l.Segment( i ).B, arc->GetWidth() ); const SFVEC2F a3DU = TO_SFVEC2F( seg.GetSeg().A ); const SFVEC2F b3DU = TO_SFVEC2F( seg.GetSeg().B ); const double width3DU = TO_3DU( arc->GetWidth() + clearance.x * 2 ); // Cannot add segments that have the same start and end point if( Is_segment_a_circle( a3DU, b3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( a3DU, width3DU / 2, *aPad ) ); else aContainer->Add( new ROUND_SEGMENT_2D( a3DU, b3DU, width3DU, *aPad ) ); } } break; default: UNIMPLEMENTED_FOR( SHAPE_TYPE_asString( shape->Type() ) ); break; } } } if( !poly.IsEmpty() ) { if( clearance.x ) poly.Inflate( clearance.x, 32 ); // Add the PAD polygon ConvertPolygonToTriangles( poly, *aContainer, m_biuTo3Dunits, *aPad ); } } OBJECT_2D* BOARD_ADAPTER::createPadWithDrill( const PAD* aPad, int aInflateValue ) { VECTOR2I drillSize = aPad->GetDrillSize(); if( !drillSize.x || !drillSize.y ) { wxLogTrace( m_logTrace, wxT( "BOARD_ADAPTER::createPadWithDrill - found an invalid pad" ) ); return nullptr; } if( drillSize.x == drillSize.y ) // usual round hole { const int radius = ( drillSize.x / 2 ) + aInflateValue; return new FILLED_CIRCLE_2D( TO_SFVEC2F( aPad->GetPosition() ), TO_3DU( radius ), *aPad ); } else // Oblong hole { const SHAPE_SEGMENT* seg = aPad->GetEffectiveHoleShape(); float width = seg->GetWidth() + aInflateValue * 2; return new ROUND_SEGMENT_2D( TO_SFVEC2F( seg->GetSeg().A ), TO_SFVEC2F( seg->GetSeg().B ), TO_3DU( width ), *aPad ); } } void BOARD_ADAPTER::addPads( const FOOTPRINT* aFootprint, CONTAINER_2D_BASE* aContainer, PCB_LAYER_ID aLayerId, bool aSkipNPTHPadsWihNoCopper, bool aSkipPlatedPads, bool aSkipNonPlatedPads ) { for( PAD* pad : aFootprint->Pads() ) { if( !pad->IsOnLayer( aLayerId ) ) continue; // Skip pad annulus when not connected on this layer (if removing is enabled) if( !pad->FlashLayer( aLayerId ) && IsCopperLayer( aLayerId ) ) continue; // NPTH pads are not drawn on layers if the // shape size and pos is the same as their hole: if( aSkipNPTHPadsWihNoCopper && ( pad->GetAttribute() == PAD_ATTRIB::NPTH ) ) { if( pad->GetDrillSize() == pad->GetSize() && pad->GetOffset() == wxPoint( 0, 0 ) ) { switch( pad->GetShape() ) { case PAD_SHAPE::CIRCLE: if( pad->GetDrillShape() == PAD_DRILL_SHAPE_CIRCLE ) continue; break; case PAD_SHAPE::OVAL: if( pad->GetDrillShape() != PAD_DRILL_SHAPE_CIRCLE ) continue; break; default: break; } } } const bool isPlated = ( ( aLayerId == F_Cu ) && pad->FlashLayer( F_Mask ) ) || ( ( aLayerId == B_Cu ) && pad->FlashLayer( B_Mask ) ); if( aSkipPlatedPads && isPlated ) continue; if( aSkipNonPlatedPads && !isPlated ) continue; VECTOR2I margin( 0, 0 ); switch( aLayerId ) { case F_Mask: case B_Mask: margin.x += pad->GetSolderMaskExpansion(); margin.y += pad->GetSolderMaskExpansion(); break; case F_Paste: case B_Paste: margin += pad->GetSolderPasteMargin(); break; default: break; } createPadWithMargin( pad, aContainer, aLayerId, margin ); } } // based on TransformArcToPolygon function from // common/convert_basic_shapes_to_polygon.cpp void BOARD_ADAPTER::transformArcToSegments( const VECTOR2I& aCentre, const VECTOR2I& aStart, const EDA_ANGLE& aArcAngle, int aCircleToSegmentsCount, int aWidth, CONTAINER_2D_BASE* aContainer, const BOARD_ITEM& aOwner ) { VECTOR2I arc_start, arc_end; EDA_ANGLE arcAngle( aArcAngle ); EDA_ANGLE delta = ANGLE_360 / aCircleToSegmentsCount; // rotate angle arc_end = arc_start = aStart; if( arcAngle != ANGLE_360 ) RotatePoint( arc_end, aCentre, -arcAngle ); if( arcAngle < ANGLE_0 ) { std::swap( arc_start, arc_end ); arcAngle = -arcAngle; } // Compute the ends of segments and creates poly VECTOR2I curr_end = arc_start; VECTOR2I curr_start = arc_start; for( EDA_ANGLE ii = delta; ii < arcAngle; ii += delta ) { curr_end = arc_start; RotatePoint( curr_end, aCentre, -ii ); const SFVEC2F start3DU = TO_SFVEC2F( curr_start ); const SFVEC2F end3DU = TO_SFVEC2F( curr_end ); if( Is_segment_a_circle( start3DU, end3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( start3DU, TO_3DU( aWidth / 2 ), aOwner ) ); else aContainer->Add( new ROUND_SEGMENT_2D( start3DU, end3DU, TO_3DU( aWidth ), aOwner ) ); curr_start = curr_end; } if( curr_end != arc_end ) { const SFVEC2F start3DU = TO_SFVEC2F( curr_end ); const SFVEC2F end3DU = TO_SFVEC2F( arc_end ); if( Is_segment_a_circle( start3DU, end3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( start3DU, TO_3DU( aWidth / 2 ), aOwner ) ); else aContainer->Add( new ROUND_SEGMENT_2D( start3DU, end3DU, TO_3DU( aWidth ), aOwner ) ); } } void BOARD_ADAPTER::addShape( const PCB_SHAPE* aShape, CONTAINER_2D_BASE* aContainer, const BOARD_ITEM* aOwner ) { // The full width of the lines to create // The extra 1 protects the inner/outer radius values from degeneracy const int linewidth = aShape->GetWidth() + 1; PLOT_DASH_TYPE lineStyle = aShape->GetStroke().GetPlotStyle(); if( lineStyle <= PLOT_DASH_TYPE::FIRST_TYPE ) { switch( aShape->GetShape() ) { case SHAPE_T::CIRCLE: { const SFVEC2F center3DU = TO_SFVEC2F( aShape->GetCenter() ); float inner_radius3DU = TO_3DU( aShape->GetRadius() - linewidth / 2 ); float outer_radius3DU = TO_3DU( aShape->GetRadius() + linewidth / 2 ); if( inner_radius3DU < 0 ) inner_radius3DU = 0; if( aShape->IsFilled() ) aContainer->Add( new FILLED_CIRCLE_2D( center3DU, outer_radius3DU, *aOwner ) ); else aContainer->Add( new RING_2D( center3DU, inner_radius3DU, outer_radius3DU, *aOwner ) ); } break; case SHAPE_T::RECT: if( aShape->IsFilled() ) { SHAPE_POLY_SET polyList; aShape->TransformShapeWithClearanceToPolygon( polyList, UNDEFINED_LAYER, 0, ARC_HIGH_DEF, ERROR_INSIDE ); polyList.Simplify( SHAPE_POLY_SET::PM_FAST ); ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner ); } else { std::vector pts = aShape->GetRectCorners(); aContainer->Add( new ROUND_SEGMENT_2D( TO_SFVEC2F( pts[0] ), TO_SFVEC2F( pts[1] ), TO_3DU( linewidth ), *aOwner ) ); aContainer->Add( new ROUND_SEGMENT_2D( TO_SFVEC2F( pts[1] ), TO_SFVEC2F( pts[2] ), TO_3DU( linewidth ), *aOwner ) ); aContainer->Add( new ROUND_SEGMENT_2D( TO_SFVEC2F( pts[2] ), TO_SFVEC2F( pts[3] ), TO_3DU( linewidth ), *aOwner ) ); aContainer->Add( new ROUND_SEGMENT_2D( TO_SFVEC2F( pts[3] ), TO_SFVEC2F( pts[0] ), TO_3DU( linewidth ), *aOwner ) ); } break; case SHAPE_T::ARC: { unsigned int segCount = GetCircleSegmentCount( aShape->GetBoundingBox().GetSizeMax() ); transformArcToSegments( aShape->GetCenter(), aShape->GetStart(), aShape->GetArcAngle(), segCount, linewidth, aContainer, *aOwner ); } break; case SHAPE_T::SEGMENT: { const SFVEC2F start3DU = TO_SFVEC2F( aShape->GetStart() ); const SFVEC2F end3DU = TO_SFVEC2F( aShape->GetEnd() ); const double linewidth3DU = TO_3DU( linewidth ); if( Is_segment_a_circle( start3DU, end3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( start3DU, linewidth3DU / 2, *aOwner ) ); else aContainer->Add( new ROUND_SEGMENT_2D( start3DU, end3DU, linewidth3DU, *aOwner ) ); } break; case SHAPE_T::BEZIER: case SHAPE_T::POLY: { SHAPE_POLY_SET polyList; aShape->TransformShapeWithClearanceToPolygon( polyList, UNDEFINED_LAYER, 0, ARC_HIGH_DEF, ERROR_INSIDE ); polyList.Simplify( SHAPE_POLY_SET::PM_FAST ); if( polyList.IsEmpty() ) // Just for caution break; ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aOwner ); } break; default: wxFAIL_MSG( wxT( "BOARD_ADAPTER::addShapeWithClearance no implementation for " ) + aShape->SHAPE_T_asString() ); break; } } else { std::vector shapes = aShape->MakeEffectiveShapes( true ); SFVEC2F a3DU; SFVEC2F b3DU; double width3DU = TO_3DU( linewidth ); const PCB_PLOT_PARAMS& plotParams = aShape->GetBoard()->GetPlotOptions(); KIGFX::PCB_RENDER_SETTINGS renderSettings; renderSettings.SetDashLengthRatio( plotParams.GetDashedLineDashRatio() ); renderSettings.SetGapLengthRatio( plotParams.GetDashedLineGapRatio() ); for( SHAPE* shape : shapes ) { STROKE_PARAMS::Stroke( shape, lineStyle, linewidth, &renderSettings, [&]( const VECTOR2I& a, const VECTOR2I& b ) { a3DU = TO_SFVEC2F( a ); b3DU = TO_SFVEC2F( b ); if( Is_segment_a_circle( a3DU, b3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( a3DU, width3DU / 2, *aOwner ) ); else aContainer->Add( new ROUND_SEGMENT_2D( a3DU, b3DU, width3DU, *aOwner ) ); } ); } for( SHAPE* shape : shapes ) delete shape; } } void BOARD_ADAPTER::addSolidAreasShapes( const ZONE* aZone, CONTAINER_2D_BASE* aContainer, PCB_LAYER_ID aLayerId ) { // Copy the polys list because we have to simplify it SHAPE_POLY_SET polyList = SHAPE_POLY_SET( *aZone->GetFilledPolysList( aLayerId ) ); // This convert the poly in outline and holes ConvertPolygonToTriangles( polyList, *aContainer, m_biuTo3Dunits, *aZone ); } void BOARD_ADAPTER::buildPadOutlineAsSegments( const PAD* aPad, CONTAINER_2D_BASE* aContainer, int aWidth ) { if( aPad->GetShape() == PAD_SHAPE::CIRCLE ) // Draw a ring { const SFVEC2F center3DU = TO_SFVEC2F( aPad->ShapePos() ); const int radius = aPad->GetSize().x / 2; const float inner_radius3DU = TO_3DU( radius - aWidth / 2 ); const float outer_radius3DU = TO_3DU( radius + aWidth / 2 ); aContainer->Add( new RING_2D( center3DU, inner_radius3DU, outer_radius3DU, *aPad ) ); return; } // For other shapes, add outlines as thick segments in polygon buffer const std::shared_ptr& corners = aPad->GetEffectivePolygon(); const SHAPE_LINE_CHAIN& path = corners->COutline( 0 ); for( int j = 0; j < path.PointCount(); j++ ) { SFVEC2F start3DU = TO_SFVEC2F( path.CPoint( j ) ); SFVEC2F end3DU = TO_SFVEC2F( path.CPoint( j + 1 ) ); if( Is_segment_a_circle( start3DU, end3DU ) ) aContainer->Add( new FILLED_CIRCLE_2D( start3DU, TO_3DU( aWidth / 2 ), *aPad ) ); else aContainer->Add( new ROUND_SEGMENT_2D( start3DU, end3DU, TO_3DU( aWidth ), *aPad ) ); } }