{"id":2650,"date":"2025-01-24T14:43:45","date_gmt":"2025-01-24T19:43:45","guid":{"rendered":"https:\/\/stepinto.vision\/?p=2650"},"modified":"2025-01-25T05:21:12","modified_gmt":"2025-01-25T10:21:12","slug":"realitykit-basics-create-shapes","status":"publish","type":"post","link":"https:\/\/stepinto.vision\/example-code\/realitykit-basics-create-shapes\/","title":{"rendered":"RealityKit Basics: Create Shapes"},"content":{"rendered":"\n

Creating primitive shapes in code.<\/p>\n\n\n\n

Overview<\/h2>\n\n\n\n

In RealityKit, we have two simple ways to create primitive shapes. <\/p>\n\n\n\n

    \n
  1. Directly in code<\/li>\n\n\n\n
  2. In Reality Composer Pro<\/li>\n<\/ol>\n\n\n\n

    Oddly, there these two have a different selection of shapes. For example, in code we can generate planes, but in Reality Composer Pro we can’t. <\/p>\n\n\n\n

    Here are a few example of creating shapes in code. We place these in a volume.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Example Code<\/h2>\n\n\n\n
    <\/path><\/path><\/svg><\/span>
    struct<\/span> <\/span>Example038<\/span>: View {<\/span><\/span>\n    <\/span>var<\/span> body: some View {<\/span><\/span>\n        RealityView { content, attachments <\/span>in<\/span><\/span>\n<\/span>\n            <\/span>\/\/ Create an empty entity we can use to group our shapes<\/span><\/span>\n            <\/span>let<\/span> group = <\/span>Entity<\/span>()<\/span><\/span>\n            content.<\/span>add<\/span>(group)<\/span><\/span>\n            <\/span>\/\/ We can move this group down in the volume and scale it to 50%.<\/span><\/span>\n            group.<\/span>position<\/span> = [<\/span>0<\/span>, <\/span>-0.25<\/span>, <\/span>0<\/span>]<\/span><\/span>\n            group.<\/span>scale<\/span> = [<\/span>0.5<\/span>, <\/span>0.5<\/span>, <\/span>0.5<\/span>]<\/span><\/span>\n<\/span>\n            <\/span>\/\/ Create shapes<\/span><\/span>\n<\/span>\n            <\/span>\/\/ ModelEntity is a convenient way to create an entity with a model, shapes, and material.<\/span><\/span>\n            <\/span>let<\/span> sphere = <\/span>ModelEntity<\/span>(<\/span><\/span>\n                <\/span>mesh<\/span>: .<\/span>generateSphere<\/span>(<\/span>radius<\/span>: <\/span>0.1<\/span>),<\/span><\/span>\n                <\/span>materials<\/span>: [<\/span>SimpleMaterial<\/span>(<\/span>color<\/span>: .<\/span>stepRed<\/span>, <\/span>isMetallic<\/span>: <\/span>false<\/span>)])<\/span><\/span>\n            <\/span>\/\/ Set the position of the sphere relative to the group<\/span><\/span>\n            sphere.<\/span>setPosition<\/span>([<\/span>-0.5<\/span>, <\/span>0<\/span>, <\/span>0<\/span>], <\/span>relativeTo<\/span>: group)<\/span><\/span>\n            <\/span>\/\/ Add the sphere as a child to the group<\/span><\/span>\n            group.<\/span>addChild<\/span>(sphere)<\/span><\/span>\n<\/span>\n            <\/span>let<\/span> box = <\/span>ModelEntity<\/span>(<\/span><\/span>\n                <\/span>mesh<\/span>: .<\/span>generateBox<\/span>(<\/span>size<\/span>: <\/span>0.2<\/span>),<\/span><\/span>\n                <\/span>materials<\/span>: [<\/span>SimpleMaterial<\/span>(<\/span>color<\/span>: .<\/span>stepGreen<\/span>, <\/span>isMetallic<\/span>: <\/span>false<\/span>)])<\/span><\/span>\n            box.<\/span>setPosition<\/span>([<\/span>0<\/span>, <\/span>-0.1<\/span>, <\/span>0<\/span>], <\/span>relativeTo<\/span>: group)<\/span><\/span>\n            group.<\/span>addChild<\/span>(box)<\/span><\/span>\n<\/span>\n            <\/span>let<\/span> cylinder = <\/span>ModelEntity<\/span>(<\/span><\/span>\n                <\/span>mesh<\/span>: .<\/span>generateCylinder<\/span>(<\/span>height<\/span>: <\/span>0.2<\/span>, <\/span>radius<\/span>: <\/span>0.1<\/span>),<\/span><\/span>\n                <\/span>materials<\/span>: [<\/span>SimpleMaterial<\/span>(<\/span>color<\/span>: .<\/span>stepBlue<\/span>, <\/span>isMetallic<\/span>: <\/span>false<\/span>)])<\/span><\/span>\n            cylinder.<\/span>setPosition<\/span>([<\/span>0.5<\/span>, <\/span>0<\/span>, <\/span>0<\/span>], <\/span>relativeTo<\/span>: group)<\/span><\/span>\n            group.<\/span>addChild<\/span>(cylinder)<\/span><\/span>\n<\/span>\n            <\/span>let<\/span> cone = <\/span>ModelEntity<\/span>(<\/span><\/span>\n                <\/span>mesh<\/span>: .<\/span>generateCone<\/span>(<\/span>height<\/span>: <\/span>0.2<\/span>, <\/span>radius<\/span>: <\/span>0.075<\/span>),<\/span><\/span>\n                <\/span>materials<\/span>: [<\/span>SimpleMaterial<\/span>(<\/span>color<\/span>: .<\/span>stepBlue<\/span>, <\/span>isMetallic<\/span>: <\/span>false<\/span>)])<\/span><\/span>\n            cone.<\/span>setPosition<\/span>([<\/span>0.4<\/span>, <\/span>0.5<\/span>, <\/span>0<\/span>], <\/span>relativeTo<\/span>: group)<\/span><\/span>\n            group.<\/span>addChild<\/span>(cone)<\/span><\/span>\n<\/span>\n            <\/span>let<\/span> plane = <\/span>ModelEntity<\/span>(<\/span><\/span>\n                <\/span>mesh<\/span>: .<\/span>generatePlane<\/span>(<\/span>width<\/span>: <\/span>0.2<\/span>, <\/span>height<\/span>: <\/span>0.2<\/span>),<\/span><\/span>\n                <\/span>materials<\/span>: [<\/span>SimpleMaterial<\/span>(<\/span>color<\/span>: .<\/span>stepGreen<\/span>, <\/span>isMetallic<\/span>: <\/span>false<\/span>)])<\/span><\/span>\n            plane.<\/span>setPosition<\/span>([<\/span>-0.4<\/span>, <\/span>0.5<\/span>, <\/span>0<\/span>], <\/span>relativeTo<\/span>: group)<\/span><\/span>\n            group.<\/span>addChild<\/span>(plane)<\/span><\/span>\n<\/span>\n        } update: { content, attachments <\/span>in<\/span><\/span>\n            <\/span>\/\/ More on update later<\/span><\/span>\n        } attachments: {<\/span><\/span>\n            <\/span>\/\/ More on attachments later<\/span><\/span>\n            <\/span>Attachment<\/span>(<\/span>id<\/span>: <\/span>"AttachmentContent"<\/span>) {<\/span><\/span>\n                <\/span>Text<\/span>(<\/span>""<\/span>)<\/span><\/span>\n            }<\/span><\/span>\n        }<\/span><\/span>\n    }<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"
    Creating primitive shapes in code.<\/p>\n","protected":false},"author":93705089,"featured_media":2663,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"_EventAllDay":false,"_EventTimezone":"","_EventStartDate":"","_EventEndDate":"","_EventStartDateUTC":"","_EventEndDateUTC":"","_EventShowMap":false,"_EventShowMapLink":false,"_EventURL":"","_EventCost":"","_EventCostDescription":"","_EventCurrencySymbol":"","_EventCurrencyCode":"","_EventCurrencyPosition":"","_EventDateTimeSeparator":"","_EventTimeRangeSeparator":"","_EventOrganizerID":[],"_EventVenueID":[],"_OrganizerEmail":"","_OrganizerPhone":"","_OrganizerWebsite":"","_VenueAddress":"","_VenueCity":"","_VenueCountry":"","_VenueProvince":"","_VenueState":"","_VenueZip":"","_VenuePhone":"","_VenueURL":"","_VenueStateProvince":"","_VenueLat":"","_VenueLng":"","_VenueShowMap":false,"_VenueShowMapLink":false,"_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":true,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false},"version":2},"_wpas_customize_per_network":false,"jetpack_post_was_ever_published":false},"categories":[1365],"tags":[],"class_list":["post-2650","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-example-code"],"jetpack_publicize_connections":[],"taxonomy_info":{"category":[{"value":1365,"label":"Example Code"}]},"featured_image_src_large":["https:\/\/i0.wp.com\/stepinto.vision\/wp-content\/uploads\/2025\/01\/step-example-039-02.jpeg?fit=1024%2C768&ssl=1",1024,768,true],"author_info":{"display_name":"Joseph Simpson","author_link":"https:\/\/stepinto.vision\/author\/vrhermit\/"},"comment_info":0,"category_info":[{"term_id":1365,"name":"Example Code","slug":"example-code","term_group":0,"term_taxonomy_id":11,"taxonomy":"category","description":"Code snippets and examples of using common APIs throughout visionOS development","parent":0,"count":187,"filter":"raw","cat_ID":1365,"category_count":187,"category_description":"Code snippets and examples of using common APIs throughout visionOS development","cat_name":"Example Code","category_nicename":"example-code","category_parent":0}],"tag_info":false,"jetpack_featured_media_url":"https:\/\/i0.wp.com\/stepinto.vision\/wp-content\/uploads\/2025\/01\/step-example-039-02.jpeg?fit=2732%2C2048&ssl=1","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/posts\/2650","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/users\/93705089"}],"replies":[{"embeddable":true,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/comments?post=2650"}],"version-history":[{"count":9,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/posts\/2650\/revisions"}],"predecessor-version":[{"id":2666,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/posts\/2650\/revisions\/2666"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/media\/2663"}],"wp:attachment":[{"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/media?parent=2650"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/categories?post=2650"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/stepinto.vision\/wp-json\/wp\/v2\/tags?post=2650"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}