2026年9月21日月曜日

Spatial Book — Features and How to Use

 

  • Core Concept

    • Spatial Book is a spatial document reader designed for Apple Vision Pro.

    • It can import text files and PDF documents and display them as three-dimensional books.

    • Pages can be turned directly by pinching and dragging them, similar to turning a physical sheet of paper.

    • Pages bend dynamically as they are dragged.

    • If you release a page midway through a turn, it falls toward the nearer side depending on its position.

    • Documents can be opened either in a standard Window or in Immersive Space.

    • When Advanced Mode is enabled, pages can also be treated as individual spatial objects rather than only as pages inside a book.

  • Supported Files

    • PDF files can be imported.

    • Text files can be imported.

    • The current text importer supports UTF-8, Shift_JIS, EUC-JP, and UTF-16 encoding detection.

    • The imported file name is used as the book title.

    • A built-in sample book is included.

    • Multiple imported documents can be kept in the library and opened independently.

  • Library

    • Use “Open File” to import a text file or PDF.

    • Use “Open Sample” to open the built-in sample document.

    • Imported documents appear in the Bookshelf.

    • Each document can be opened either:

      • in a Window

      • in Immersive Space

    • Multiple books can also be sent into Immersive Space together.

    • The Library window can be reopened while Immersive Space is active.

    • The entire Immersive Space can be closed from the Library.

    • A confirmation is shown before closing the whole space because spatial layouts and placed pages cannot currently be restored afterward.

  • Text Typesetting

    • Text size can be adjusted for imported text files.

    • The current range is 13 pt to 26 pt.

    • Horizontal left-to-right layout is supported.

    • Vertical right-to-left layout is also supported.

    • In vertical mode, book opening direction and page navigation are adjusted to match a right-bound book.

    • PDF documents use their original page layout and are always treated as left-bound documents.

    • Changing typesetting settings rebuilds affected books using the new settings.

  • Paper Quality / Rendering Quality

    • The rendering quality of spatial page cards used in Advanced Mode can be adjusted.

    • Standard

      • Prioritizes the number of visible pages and lower resource usage.

    • High

      • Balances rendering quality and page count.

    • Ultra

      • Prioritizes image quality and renders spatial cards at a resolution closer to the main book pages.

    • Higher quality settings reduce the number of high-resolution page textures kept in memory at the same time.

    • For Stack and Grid layouts, the current number of detailed pages per group is:

      • Standard: up to 60 pages

      • High: up to 40 pages

      • Ultra: up to 24 pages

    • Row Mode can represent many pages while only loading detailed textures around the currently focused page.

    • The current detailed texture windows for Row Mode are:

      • Standard: focused page + 12 pages on each side, up to 25 loaded pages

      • High: focused page + 8 pages on each side, up to 17 loaded pages

      • Ultra: focused page + 5 pages on each side, up to 11 loaded pages

    • Stack, Grid, and Row layouts are designed so that large documents do not require every page image to remain loaded on the GPU at the same time.

  • Window Mode

    • Displays the document as a 3D book inside a visionOS volume window.

    • Pages can be turned directly with pinch-and-drag gestures.

    • Previous and next page buttons are provided below the book.

    • Page buttons support press-and-hold for continuous page turning.

    • The current page or spread position is displayed.

    • A slider allows quick navigation to distant parts of the document.

    • In vertical text mode, page navigation and slider direction are reversed to match right-to-left book progression.

    • Resizing the volume window also scales the 3D book accordingly.

  • Immersive Mode — Basics

    • Books can be placed as 3D objects in the surrounding space.

    • Multiple books can be opened in the same Immersive Space.

    • Newly opened books are initially arranged next to one another.

    • Each book can be read and moved independently.

    • One book is treated as the currently focused book for menu operations.

    • When focus changes, a temporary light-blue marker appears above the selected book so you can see which book is active.

    • The marker gradually shrinks and disappears after a short time.

  • Immersive Mode — Page Turning

    • Pages can be turned directly with pinch-and-drag gestures, just like in Window Mode.

    • Previous and next page controls are also available from the spatial menu.

    • Vertical text uses right-to-left page progression.

  • Immersive Mode — Moving Books by Hand

    • Either hand can be used.

    • Making a fist near a movable book grabs the nearest eligible book.

    • If several books are nearby, the nearest one to the hand is selected.

    • While keeping the hand closed, moving the hand moves the book with it.

    • Opening the hand releases the book and leaves it at the current location.

    • A grab begins only when the fist gesture is first detected, which helps prevent unintended repeated grabbing while the hand remains closed.

    • While holding a book, wrist orientation can also be used to adjust the viewing tilt.

    • A “Reset Tilt” control restores the book to its default reading angle.

  • Immersive Mode — Summoning Distant Books

    • Look at a distant book and double-pinch to bring it toward you.

    • This allows books to be retrieved without physically moving across the room.

    • The summoned book is placed slightly in front of and below the user’s head position.

  • Immersive Mode — Resizing Books

    • A light-blue spherical handle appears at the lower-right corner of the focused book.

    • Pinch and drag the handle to resize the entire book.

    • The resize handle appears only when that book is focused and its control menu is expanded, helping keep the reading view uncluttered.

  • Immersive Mode — Spatial Control Menu

    • A shared control panel is used for the currently focused book.

    • The panel displays information such as the book title and current mode or status.

    • By default, the panel appears in front of the user.

    • It does not rigidly follow every small head movement.

    • Instead, it begins moving only after the user moves far enough away, then smoothly catches up.

    • The panel continually rotates to face the user.

    • The panel can be pinned in place.

    • When pinned, it stops following the user.

    • A light-blue handle appears above the pinned panel.

    • Pinch and drag that handle to reposition the panel anywhere in space.

    • Unpinning the panel restores its head-following behavior.

    • The panel can also be collapsed.

    • When collapsed, it becomes a small “…” button to reduce visual obstruction while reading.

    • Pressing the button expands the full panel again.

    • A Library button reopens the Library window.

    • “Close Book” closes only the currently focused book from Immersive Space.

    • A confirmation is shown before closing a book if spatial layouts or detached pages will be removed.

    • Other open books and the Immersive Space itself remain active when one book is closed.

  • Focus Mode / Background

    • Passthrough (MR)

      • Displays books over the real environment.

    • Focus - Dark

      • Hides passthrough and places the user in a dark fully immersive environment.

    • Focus - Grid Room

      • Uses a fully immersive environment with a large grid floor.

      • Hides the real environment while preserving a strong sense of spatial position.

      • The grid fades into darkness toward the edges to create the impression of a larger continuous space.

  • Advanced Mode

    • Advanced Mode is disabled by default.

    • With Advanced Mode off, Spatial Book focuses on the standard reading experience.

    • Enabling Advanced Mode adds the following spatial document layouts:

      • Book

      • Stack

      • Grid

      • Row

    • You can switch directly between Book, Stack, Grid, and Row modes.

    • Accordion is a special interactive expansion state entered from Stack Mode.

    • Turning Advanced Mode off while another layout is active returns documents to normal Book Mode.

    • This allows users who only want a traditional reader to ignore the more experimental spatial tools entirely.

  • Advanced — Book Mode

    • Standard 3D book presentation.

    • Pages can be turned directly.

    • Previous and next page controls are available from the menu.

    • The book can be grabbed and moved with a fist gesture.

    • The blue handle can be used to resize the book.

    • “Reset Tilt” restores the default reading angle.

    • Other Advanced layouts can always be returned to Book Mode.

  • Advanced — Stack Mode

    • Breaks the document into individual page cards and displays them as physical stacks of paper.

    • Large documents are divided into multiple manageable stacks instead of one extremely thick stack.

    • Stack size depends on the selected Paper Quality setting.

    • Each stack can be positioned independently.

    • Tapping a stack selects it as the active stack.

    • Detailed textures are loaded around the currently selected stack.

    • A stack can be grabbed with a fist and moved through space.

    • When several stacks are present, only the stack nearest to the grabbing hand is moved.

    • Other stacks remain where they are.

    • Looking at a stack and double-pinching summons only that stack toward the user.

    • While holding a stack with one fist, bringing the other fist close to it begins Accordion expansion.

  • Advanced — Accordion Expansion

    • Accordion is a special spatial expansion entered from Stack Mode.

    • Grab a stack with one fist.

    • Bring the other hand close while also making a fist.

    • The pages expand between the two hands.

    • The positions of the hands determine the two ends of the expanded page sequence.

    • Moving the hands farther apart increases spacing between pages.

    • Moving them closer together compresses the layout.

    • The pages are oriented to remain readable from the user’s position.

    • Opening either hand freezes the current arrangement in space.

    • Once frozen, both hands can be released while the pages remain spread out.

    • Previously frozen stacks can remain expanded even while another stack is manipulated.

    • After freezing, moving a fingertip close to a page causes the nearest page to protrude slightly as a preview.

    • Pinching that page pulls a single page out of the Accordion layout.

    • The detached page immediately follows the pinching hand.

    • Releasing the pinch leaves the page at that position.

    • The two ends of a frozen Accordion layout can be grabbed again with two fists to resume adjusting the spread.

    • The layout also supports grabbing the two ends with opposite hands.

    • An “Adjust” button is available as an alternative way to resume editing if the gesture is difficult to perform.

    • “To Stack” collapses the expanded Accordion back into Stack form.

  • Advanced — Grid Mode

    • Displays pages as a spatial grid for overview and comparison.

    • Many pages can be viewed simultaneously.

    • Large documents are divided into multiple Grid panels.

    • Each panel contains a manageable number of pages.

    • Only pages near the currently active panel keep detailed textures loaded.

    • Looking at another Grid panel and pinching brings that panel into the active position.

    • Looking at and pinching a page on the active Grid detaches that page and places it into the surrounding space.

    • Detached pages are initially positioned in front of the user.

    • Multiple detached pages are offset horizontally to avoid directly overlapping one another.

    • Detached pages remain in space when switching to another Grid panel.

    • Pinching the original Grid slot of a detached page again returns that page to the Grid.

    • The Grid itself can be grabbed with a fist and repositioned.

    • The menu displays information such as page count, current panel, and number of detached pages.

    • A Return control can return detached pages to their source layout.

  • Advanced — Manipulating Detached Pages

    • Pages can be detached from Grid, Accordion, and Row layouts and treated as independent spatial objects.

    • Detached pages remain in space independently of their source layout.

    • Pinch and drag a detached page to move it.

    • A placed page can be grabbed again later.

    • Re-grabbing uses a stricter proximity and pinch threshold to reduce accidental page pickup.

    • Detached pages can be scaled using a magnification gesture.

    • Detached pages can be rotated freely using a 3D rotation gesture.

    • The same page can also be pinched with both hands.

    • The distance between the hands controls page scale.

    • Hand orientation can be used to rotate the page.

    • If one hand is released during a two-handed transformation, the remaining hand can continue holding the page.

    • A page can also be transferred from one hand to the other.

    • This allows pages from different parts of a document to be placed next to one another for comparison.

    • Detached pages can also be returned to their original layout in a batch.

  • Advanced — Row Mode

    • Arranges document pages in one long horizontal row.

    • Instead of turning one page at a time, the entire document can be browsed as a continuous spatial sequence.

    • Pinch and drag horizontally to scroll through the row.

    • Larger swipe distances can move through multiple pages continuously.

    • When the gesture ends, the row snaps to the nearest page.

    • Previous and next controls are also available from the menu.

    • The current page and total page count are displayed.

    • Tapping a Row card selects that Row as the active document.

    • Pinching and holding a page without immediately swiping allows that page to be detached from the Row.

    • Detached pages can then be placed and manipulated independently like pages from Grid or Accordion.

    • The entire Row can be grabbed with a fist and repositioned in space.

    • Two visual styles are available:

      • Flat

      • Emphasized

    • Flat mode keeps pages aligned uniformly in the row.

    • Emphasized mode moves the focused page forward and enlarges it for easier reading.

    • Row Mode does not keep full-resolution textures on every page simultaneously.

    • Only the pages near the current focus are loaded in detail.

    • The current implementation can represent up to 1,000 Row cards.

  • Using Multiple Documents in Space

    • Multiple books can coexist in the same Immersive Space.

    • Each document can independently use Book, Stack, Grid, or Row layout.

    • For example, one document can remain open as a normal book while another is displayed as a Grid.

    • The shared control panel operates on one focused document at a time.

    • Interacting with another book, stack, Grid, or Row changes the focused document.

    • A light-blue indicator briefly shows which document is now active.

    • Closing one document does not close the others.

  • Interaction Safeguards

    • Closing a book requires confirmation when spatial content may be lost.

    • Closing the entire Immersive Space also requires confirmation.

    • The interface warns that current spatial layouts cannot be restored after closing.

    • If detached pages exist, the close confirmation indicates that they will also be removed.

    • Fist-based grabbing is triggered only when the fist gesture begins, helping prevent repeated unintended grabs.

    • Page extraction from Accordion also reacts to the start of a pinch rather than a continuously held pinch.

    • Picking up an already detached page uses a stricter pinch threshold.

    • During two-handed Accordion manipulation, normal book grabbing is temporarily suppressed.

    • The spatial menu does not rigidly follow every small head movement, reducing distracting motion.

    • Large documents use selective texture loading so that only nearby or relevant pages stay at high resolution.

  • In Short

    • In its simplest form, Spatial Book is a reader that turns text files and PDFs into 3D books that can be read by physically turning their pages.

    • In Immersive Mode, it becomes a spatial library where multiple books can be placed around the user.

    • With Advanced Mode enabled, it also becomes a spatial document viewer where pages can be separated from the book, stacked, expanded, arranged in grids or rows, detached, moved, scaled, rotated, and compared directly in space.

0 件のコメント:

コメントを投稿