Architectural Capture & 360 Standards
Precision virtual walkthroughs begin with calibrated optical capture. Adhering to these camera elevations, aspect ratios, and exposure brackets ensures seamless spatial continuity across your property.
Ricoh Theta Z1
Dual 1.0-inch back-illuminated CMOS sensors. Essential for low-light interior penthouses. Capture in RAW DNG 9-bracket HDR mode for optimal dynamic range.
Insta360 X3 / X4
72MP native panoramic stills with 8K texture resolution. Excellent automated bracketed exposure with Active HDR. Fast room-to-room throughput.
DSLR Nodal Brackets
Full-frame mirrorless (Sony α7R V, Canon R5) paired with an 8mm circular fisheye on a Nodal Ninja bracket. Yields 16K gigapixel architectural archival clarity.
Studio Capture Benchmarks
Responsive Website & Portal Embedding
PenTwin 360° spatial walkthroughs are engineered for fluid zero-friction embedding across luxury architectural agency websites, high-conversion developer portals, and MLS registries.
<div style="position: relative; width: 100%; aspect-ratio: 16/9; overflow: hidden; border-radius: 12px; background: #2C332E;">
<iframe
src="https://twin.pen.homes/tours/demo/embed?autorotate=true&speed=0.3"
title="PenTwin Architectural Virtual Walkthrough"
allow="fullscreen; accelerometer; gyroscope; xr-spatial-tracking"
loading="lazy"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
></iframe>
</div>Critical Feature Policy Permissions
To ensure gyroscope motion steering, fullscreen expansiveness, and WebXR VR headset immersion operate across cross-origin iframes, the following permissions must be included in your allow attribute:
Enables edge-to-edge distraction-free immersion when clicking the expand HUD button.
Allows mobile visitors to physically look around rooms by rotating their phone in physical space.
Essential for Apple Vision Pro, Meta Quest 3, and WebXR 6DoF stereo headset sessions.
Prevents initial homepage blocking until the client scrolls to the observatory container.
CMS & Real Estate Integration Recipes
Add a Custom Code element to your section. Paste the snippet above and assign your container a relative wrapper with w-full and h-[80vh].
Use the Custom HTML Block in Gutenberg or the HTML Widget in Elementor. Paste the snippet directly.
Insert a Code Block (set Display to HTML). Disable the "Preview in Safe Mode" warning to view the interactive canvas.
Paste the direct embed URL with ?brand=false into your MLS "Unbranded Virtual Tour URL" field to ensure strict MLS compliance.
Embed URL Query Parameters Reference
Tailor every embedded tour experience in real time using URL search parameters. Instantly configure camera rotation velocity, gallery kiosk timeouts, atmospheric sunlight studies, and field of view.
Interactive Embed URL & Snippet Generator
Configure parameters to generate production-ready iFrames and customized embed URLs.
<div style="position: relative; width: 100%; aspect-ratio: 16/9; overflow: hidden; border-radius: 12px; background: #2C332E;">
<iframe
src="https://twin.pen.homes/tours/demo/embed"
title="PenTwin Architectural Virtual Tour"
allow="fullscreen; accelerometer; gyroscope; xr-spatial-tracking"
loading="lazy"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
></iframe>
</div>Query Parameters Reference Table
GET query string| Parameter | Type | Default | Permitted Values | Description |
|---|---|---|---|---|
| ?scene | string | scene-1 | scene UUID | Directly initializes the tour inside a specific room or terrace. |
| ?autorotate | boolean | false | true, false | Activates gentle 360° continuous camera yaw rotation on load. |
| ?speed | number | 0.3 | 0.05 – 2.0 | Camera auto-rotation angular speed multiplier. |
| ?kiosk | boolean | false | 1, true | Physical gallery display mode with idle timeout resets and secured HUD. |
| ?solar | string | midday | dawn, midday, golden-hour, twilight, night | Applies real-time celestial sun angle, shadow casting, and sky tone. |
| ?weather | string | clear | clear, rain, coastal_fog, snow, storm | Simulates atmospheric precipitation, mist, and matching acoustic audio. |
| ?fov | number | 75 | 20 – 95 | Sets initial perspective camera field of view in degrees. |
| ?hud | boolean | 1 | 0, false | Clean cinema mode: hides room selectors and badges for minimalist hero displays. |
| ?minimap | boolean | true | false | Suppresses the architectural floor plan radar widget. |
| ?brand | boolean | true | false | Suppresses bottom studio watermarks for MLS compliance. |
| ?tonemapping | string | aces | aces, agx, neutral, reinhard | Sets WebGL filmic color tone curve and HDR compression profile. |
VIP Client Gate & CRM Webhooks
Protect confidential trophy residences with mandatory NDA agreements, private viewing requests, and real-time webhook dispatch directly into your agency CRM or Slack channel.
HTTP POST Delivery Specifications
POST
application/json
PenTwin-Spatial-Observatory/1.0
{
"event": "tour.lead.created",
"timestamp": "2026-09-24T16:00:00.000Z",
"lead": {
"id": "c9a41f3e-821b-4f9a-9e12-32a104f7b2c9",
"name": "Alexander Wright",
"email": "alexander.wright@private-acquisitions.com",
"phone": "+1 (555) 234-8901",
"company": "Wright & Associates Family Office",
"ndaAccepted": true,
"ndaAcceptedAt": "2026-09-24T15:58:32.000Z",
"inquiryMessage": "Inquiring on behalf of a private buyer interested in the primary penthouse and bespoke timber joinery.",
"preferredDate": "Tuesday at 2:00 PM EST",
"source": "gate",
"sceneName": "Living Pavilion",
"metadata": {
"referrer": "https://architecturaldigest.com"
}
},
"tour": {
"id": "e289bf44-67a1-432d-8b0d-1c3905e3f112",
"name": "Villa Solaris Penthouse",
"slug": "villa-solaris",
"url": "https://twin.pen.homes/tours/villa-solaris",
"studioUrl": "https://twin.pen.homes/dashboard/tours/e289bf44-67a1-432d-8b0d-1c3905e3f112"
}
}Zapier & Make (Integromat)
Create a new Catch Webhook trigger in Zapier or a Custom Webhook in Make. Copy the endpoint URL into your Tour Settings > VIP Gate > Webhook URL field. Click Test Webhook to verify instantly.
HubSpot & Salesforce
Automatically create High-Net-Worth Lead records, map private acquisition notes, and trigger automated personal correspondence from the listing broker.
Slack Incoming Webhooks Support
PenTwin includes native Slack BlockKit detection. If your webhook URL contains hooks.slack.com, PenTwin automatically formats an executive card with client contact info, room location, and a 1-click link to the Studio Dashboard.