Skip to content

refactor(samples): polish 0.2.2 showcase samples with collapsible UI, auto-fade, and literate docs #54

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dkhawk merged 8 commits into from
Aug 24, 2026
Merged

refactor(samples): polish 0.2.2 showcase samples with collapsible UI, auto-fade, and literate docs #54

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
2562530
Enhance Advanced Camera Animation and Path Following samples
dkhawk Aug 20, 2026
8731618
feat(fieldofview,datavisualization): polish FOV and Data Visualizatio…
dkhawk Aug 21, 2026
8d28dac
feat(roadmapmode): polish Roadmap Mode with collapsible header and li…
dkhawk Aug 21, 2026
f947b51
feat(routes): polish Routes API sample with collapsible control panel…
dkhawk Aug 21, 2026
f6d7d73
docs(samples): augment literate comments explaining 3D coordinates, e…
dkhawk Aug 21, 2026
d262c6d
build: untrack and gitignore gradle-daemon-jvm.properties
dkhawk Aug 21, 2026
dd6b697
docs: update copyright headers to 2026 for camera animation step classes
dkhawk Aug 21, 2026
4e290f3
fix(samples): address PR review feedback on animation timing, tour re…
dkhawk Aug 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Gradle files
.gradle/
build/
gradle/gradle-daemon-jvm.properties

# Local configuration file (sdk path, etc)
local.properties
Expand Down Expand Up @@ -40,3 +41,5 @@ google-services.json
.vscode/
snippets/docs/
.kotlin/
.android/
scratch/
9 changes: 9 additions & 0 deletions Maps3DSamples/ApiDemos/common/src/main/res/drawable/expand_less_24px.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="24dp"
android:height="24dp"
android:viewportWidth="24"
android:viewportHeight="24">
<path
android:fillColor="#FF1C1B1F"
android:pathData="M12,8l-6,6 1.41,1.41L12,10.83l4.59,4.58L18,14z"/>
</vector>
9 changes: 9 additions & 0 deletions Maps3DSamples/ApiDemos/common/src/main/res/drawable/expand_more_24px.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="24dp"
android:height="24dp"
android:viewportWidth="24"
android:viewportHeight="24">
<path
android:fillColor="#FF1C1B1F"
android:pathData="M16.59,8.59L12,13.17 7.41,8.59 6,10l6,6 6,-6z"/>
</vector>
136 changes: 124 additions & 12 deletions Maps3DSamples/ApiDemos/common/src/main/res/layout/activity_path_following.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,25 +41,67 @@
app:cardElevation="8dp"
>

<ScrollView
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:maxHeight="320dp"
android:orientation="vertical"
>

<!-- Card Header with title and collapse/expand button -->
<LinearLayout
android:id="@+id/card_header"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:padding="12dp"
android:orientation="horizontal"
android:gravity="center_vertical"
android:paddingStart="12dp"
android:paddingEnd="6dp"
android:paddingTop="6dp"
android:paddingBottom="2dp"
>

<TextView
style="@style/TextAppearance.Material3.TitleSmall"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="@string/path_controls_title"
android:textStyle="bold"
/>

<com.google.android.material.button.MaterialButton
android:id="@+id/btn_collapse"
style="@style/Widget.Material3.Button.IconButton"
android:layout_width="40dp"
android:layout_height="40dp"
app:icon="@drawable/expand_more_24px"
app:iconTint="?attr/colorOnSurface"
android:contentDescription="@string/collapse_controls"
/>
</LinearLayout>

<ScrollView
android:id="@+id/controls_scroll"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:maxHeight="300dp"
>

<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:paddingStart="12dp"
android:paddingEnd="12dp"
android:paddingBottom="12dp"
>

<!-- Environment Selection Header -->
<TextView
style="@style/TextAppearance.Material3.LabelLarge"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Path Environment:"
android:text="@string/path_environment"
android:textStyle="bold"
/>

Expand All @@ -77,18 +119,86 @@
android:layout_height="wrap_content"
android:layout_weight="1"
android:checked="true"
android:text="Urban"
android:text="@string/urban"
/>

<RadioButton
android:id="@+id/rb_rural"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="Rural"
android:text="@string/rural"
/>
</RadioGroup>

<!-- Altitude Mode Selection -->
<TextView
style="@style/TextAppearance.Material3.LabelLarge"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="8dp"
android:text="@string/altitude_mode"
android:textStyle="bold"
/>

<RadioGroup
android:id="@+id/rg_altitude_mode"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:layout_marginTop="2dp"
>

<RadioButton
android:id="@+id/rb_relative_to_ground"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/relative_to_ground"
/>

<RadioButton
android:id="@+id/rb_clamp_to_ground"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:checked="true"
android:text="@string/clamp_to_ground"
/>

<RadioButton
android:id="@+id/rb_relative_to_mesh"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/relative_to_mesh"
/>

<RadioButton
android:id="@+id/rb_absolute"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/absolute"
/>
</RadioGroup>

<!-- Path Height (Relative Altitude) Slider -->
<TextView
android:id="@+id/path_altitude_slider_label"
style="@style/TextAppearance.Material3.LabelMedium"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="4dp"
android:text="@string/default_path_height"
/>

<com.google.android.material.slider.Slider
android:id="@+id/path_altitude_slider"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:valueFrom="0.0"
android:valueTo="10.0"
android:stepSize="0.1"
android:value="0.5"
/>

<!-- Play / Pause and Progress Row -->
<LinearLayout
android:layout_width="match_parent"
Expand All @@ -104,6 +214,7 @@
android:layout_width="44dp"
android:layout_height="44dp"
app:icon="@drawable/play_arrow_24px"
android:contentDescription="@string/play_or_pause_animation"
/>

<com.google.android.material.slider.Slider
Expand All @@ -124,7 +235,7 @@
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="4dp"
android:text="Camera Range: 300m"
android:text="@string/default_camera_range"
/>

<com.google.android.material.slider.Slider
Expand All @@ -141,7 +252,7 @@
style="@style/TextAppearance.Material3.LabelMedium"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Ground Altitude: 20m"
android:text="@string/default_ground_altitude"
/>

<com.google.android.material.slider.Slider
Expand All @@ -158,7 +269,7 @@
style="@style/TextAppearance.Material3.LabelMedium"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Heading Offset: 0°"
android:text="@string/default_heading_offset"
/>

<com.google.android.material.slider.Slider
Expand All @@ -175,7 +286,7 @@
style="@style/TextAppearance.Material3.LabelMedium"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Camera Tilt: 70°"
android:text="@string/default_camera_tilt"
/>

<com.google.android.material.slider.Slider
Expand All @@ -192,7 +303,7 @@
style="@style/TextAppearance.Material3.LabelMedium"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Follow Speed: 30 m/s"
android:text="@string/default_follow_speed"
/>

<com.google.android.material.slider.Slider
Expand All @@ -205,5 +316,6 @@
/>
</LinearLayout>
</ScrollView>
</LinearLayout>
</androidx.cardview.widget.CardView>
</androidx.coordinatorlayout.widget.CoordinatorLayout>
50 changes: 11 additions & 39 deletions Maps3DSamples/ApiDemos/common/src/main/res/layout/control_panel_advanced_animation.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,65 +36,37 @@
>

<TextView
style="@style/TextAppearance.Material3.LabelLarge"
style="@style/TextAppearance.Material3.TitleMedium"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Select Animation Approach:"
android:text="@string/aerial_tour_title"
android:textStyle="bold"
/>

<RadioGroup
android:id="@+id/rg_approach"
<TextView
android:id="@+id/tv_tour_status"
style="@style/TextAppearance.Material3.BodyMedium"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:layout_marginTop="4dp"
>

<RadioButton
android:id="@+id/rb_simple_flyto"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="1. SDK Simple flyTo (Native Transition)"
/>

<RadioButton
android:id="@+id/rb_keyframe_tour"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="2. Keyframe Queue (Multi-step Camera Tour)"
/>

<RadioButton
android:id="@+id/rb_dispatcher_loop"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:checked="true"
android:text="3. Frame Dispatcher (Chase Cam + 3D Airplane)"
/>

<RadioButton
android:id="@+id/rb_orbit_spin"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="4. 360° Orbit Spin (Continuous Orbital Camera)"
/>
</RadioGroup>
android:text="@string/aerial_tour_status_idle"
android:textColor="?android:attr/textColorSecondary"
/>

<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="end"
android:layout_marginTop="8dp"
android:layout_marginTop="12dp"
>

<Button
android:id="@+id/btn_reset"
style="@style/Widget.Material3.Button.OutlinedButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Reset"
android:text="@string/reset"
android:layout_marginEnd="8dp"
/>

Expand All @@ -103,7 +75,7 @@
style="@style/Widget.Material3.Button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Play"
android:text="@string/play"
/>
</LinearLayout>

Expand Down
Loading