<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Circus Company]]></title><description><![CDATA[circuscompany — Making technology fun and delicious. A global EdTech, gaming, AI and IP content company. WAGZAK (RUN · JUMP · ZemiNa · Hangul ABC) · Quiga (Quig]]></description><link>https://circuscompany.hashnode.dev</link><generator>RSS for Node</generator><lastBuildDate>Mon, 16 Nov 2026 19:33:31 GMT</lastBuildDate><atom:link href="https://circuscompany.hashnode.dev/rss.xml" rel="self" type="application/rss+xml"/><language><![CDATA[en]]></language><ttl>60</ttl><item><title><![CDATA[The paper is part of the pipeline: what printed AR markers taught us about size, light and dark crayons]]></title><description><![CDATA[Notes from a team that has been pointing phones at printed pages since 2012]]></description><link>https://circuscompany.hashnode.dev/the-paper-is-part-of-the-pipeline-what-printed-ar-markers-taught-us-about-size-light-and-dark-crayons</link><guid isPermaLink="true">https://circuscompany.hashnode.dev/the-paper-is-part-of-the-pipeline-what-printed-ar-markers-taught-us-about-size-light-and-dark-crayons</guid><category><![CDATA[Augmented Reality]]></category><category><![CDATA[edtech]]></category><category><![CDATA[Computer Vision]]></category><category><![CDATA[Mobile Development]]></category><category><![CDATA[UX]]></category><dc:creator><![CDATA[Circus Company]]></dc:creator><pubDate>Fri, 06 Nov 2026 14:53:50 GMT</pubDate><content:encoded><![CDATA[<p>We're Circus Company, a team in Seoul that started making augmented reality (AR) in 2012. Back then it was an app you pointed at Korean banknotes: when the smartphone recognized a note, the content assigned to it appeared on the screen. The app we work on now, WAGZAK RUN, does something close to that with a page a child has colored: print it, color it, point a phone at it, and the drawing moves in the colors the child picked.</p>
<p>That makes a large part of our interface a sheet of A4 that someone printed at home or at school and colored with whatever was on the table. This post is about that sheet. We won't go into how recognition works inside the app. What we can describe is what we see from the outside, and how we've written it into the product.</p>
<h3>A printed page is an input you don't control</h3>
<p>Between our PDF and the phone camera there is a printer setting, a sheet of paper, a box of crayons, a kitchen light and a hand holding a phone. None of it is ours.</p>
<p>So most of our guidance is about those things, not about the app. Here is that guidance, gathered from our FAQ:</p>
<ul>
<li>Print on A4 at 100% size.</li>
<li>Color inside the thick lines, with colored pencils.</li>
<li>Put the sheet on a flat surface, in a bright place.</li>
<li>Get the whole sheet on the screen, about a hand-span away.</li>
<li>Coloring very dark with crayons or felt-tip pens can make recognition harder.</li>
</ul>
<p>Each line is one of those variables, named so a parent or teacher can do something about it.</p>
<h3>Size is in the data</h3>
<p>Our sheet catalog is a public JSON file, and every sheet in it carries a small print spec: the paper, which is A4 for all of them, and a field called <code>marker_width_mm</code>. For 79 of the 98 sheets it is 190. The others are smaller: several sit around 98 to 104 mm, and the four Korean banknote markers range from 135.7 to 155.4 mm.</p>
<p>The source art for all 98 is the same 909 × 1287 px canvas, and the catalog records <code>ppi_at_190mm: 121.5</code>, which is just 909 pixels spread over 190 mm.</p>
<p>This is why "100%" in our instructions isn't a style preference. The width is a number we keep in the data, and a "fit to page" option in a print dialog can quietly change the width that ends up on paper. So we say the boring thing up front.</p>
<h3>Dark crayons: the failure we chose to write down</h3>
<p>Coloring is the whole point. The child's colors are what moves on the screen. And the coloring is also where things go wrong: very dark crayon or felt-tip can make the page harder to recognize.</p>
<p>We won't pretend we've solved that inside the app, and we won't describe internals we aren't writing about here. The part we can show is where the advice sits. "Use colored pencils" isn't a troubleshooting footnote for us. It is in the basic answer to "How does AR coloring work?", in the same sentence as "color inside the thick lines" and right before "scan the page so it fills the screen."</p>
<p>The lesson we keep relearning: when a failure depends on what's in the user's hand, the advice has to reach them before their hand moves, not after the camera has already struggled.</p>
<h3>Not everything should depend on paper</h3>
<p>The 98 sheets are not one kind of thing. 33 are coloring pages, and those need a printed sheet. 65 are markers that are used as printed, without coloring, and many of those can start from a screen instead: show the image large on a computer or classroom TV and point the phone at it.</p>
<p>Then there are parts of the app with no paper at all. AR friends appear on the floor: the app looks for the floor or a wall and brings a character there, and the tip is again about the room, a bright place and a slow scan of the floor. Songs and drawing need no paper either.</p>
<p>Splitting it this way means a family without a printer still has something to do. It also means every piece of guidance has to say which of the three it is about, or it points people at the wrong thing.</p>
<h3>The sheet is older than the app</h3>
<p>A sheet of paper and a phone has been our setup for a long time. In 2016 we made coloring sheets for the National Institute of Ecology (Korea), and one of them, three prairie dogs, was printed that October in the magazine of a Korean government agency, right under a paragraph we wrote about AR. The same three prairie dogs are in WAGZAK RUN today. Phones changed a lot in those years. The paper, the pencils and the table didn't change much.</p>
<h3>A question for other builders</h3>
<p>Our distance advice is "about a hand-span", not a number of centimeters.</p>
<p>If you've built something that reads printed material in homes and classrooms you don't control, how did you deal with A4 versus Letter? Did you ship two layouts, scale to fit, or tell people one size and stick to it?</p>
<p>Circus Company, the team behind WAGZAK RUN: <a href="https://run.wagzak.io">https://run.wagzak.io</a></p>
<p>The sheet catalog with the print specs: <a href="https://run.wagzak.io/markers/index.json">https://run.wagzak.io/markers/index.json</a></p>
]]></content:encoded></item></channel></rss>