Bottom line: Serialize autofocus work instead of repeatedly issuing requests while a search is pending. Agree the target window and intended field of view first, then retain one search outcome before deciding whether another adjustment is necessary.
\nAxis’s Optics Control excludes PTZ cameras from /axis-cgi/opticscontrol.cgi and directs PTZ use to /axis-cgi/com/ptz.cgi instead.
The focus-window example warns that the optimal focus position can change after setting a window and recommends a new search afterward.
\nThe autofocus example first sets magnification and warns that the requested search can take time and will fail if another request is initiated before completion.
\nDo not infer a completion deadline or automatic retry policy from these examples. Obtain the exact device’s supported optics and operation information. Keep this request-sequencing check separate from acceptance of focus across the operational depth; a processed search alone must not be described as proof of useful recorded detail.
\nThe following steps are DSE recommendations based on the cited source.
\nDSE recommends treating autofocus as one pending operation with a recorded outcome before allowing another optics request.
\nRetain the camera/software identity, optics identifier, intended magnification and window, sanitized request timing and each returned outcome. Have a reviewer follow the timeline and confirm that a second operation was not issued while the first was pending. Record unknown completion state explicitly instead of replacing it with an assumed success.
\nPerform the separate approved image-quality acceptance after request sequencing passes. Use the required scene and recorded workflow, and preserve its result separately from the API outcome. This article proposes the sequencing exercise and does not report a camera test, a successful focus result or an application-specific completion guarantee.
\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.
\n", "content_text": "Bottom line: Serialize autofocus work instead of repeatedly issuing requests while a search is pending. Agree the target window and intended field of view first, then retain one search outcome before deciding whether another adjustment is necessary.\nSource fact: documented behavior\nAxis’s Optics Control excludes PTZ cameras from /axis-cgi/opticscontrol.cgi and directs PTZ use to /axis-cgi/com/ptz.cgi instead.\nThe focus-window example warns that the optimal focus position can change after setting a window and recommends a new search afterward.\nThe autofocus example first sets magnification and warns that the requested search can take time and will fail if another request is initiated before completion.\nWhat the source does not establish\nDo not infer a completion deadline or automatic retry policy from these examples. Obtain the exact device’s supported optics and operation information. Keep this request-sequencing check separate from acceptance of focus across the operational depth; a processed search alone must not be described as proof of useful recorded detail.\nApplicability questions\n\nIs this a supported non-PTZ optics interface on the actual camera?\nWhich optics identifier and intended field of view belong to the change?\nWhat target window should the focus search use?\nWhich client component prevents another request while the search is pending?\n\nDSE recommendation: controlled next steps\nThe following steps are DSE recommendations based on the cited source.\nDSE recommends treating autofocus as one pending operation with a recorded outcome before allowing another optics request.\n\nSelect an authorized pilot camera and review its available optics and capabilities. Record the existing magnification, focus window and relevant configuration through supported read operations. Agree the intended scene with the operator owner. Set the approved magnification and window through the documented workflow rather than copying example coordinates as if they described the installed view.\nStart one autofocus search and have the client retain its request identity and pending state. Prevent repeated button presses or a separate automation from sending another optics request until the search outcome has been handled. Observe the documented response through the supported client workflow; do not substitute an arbitrary elapsed delay for evidence of completion. Escalate an unresolved or failed operation rather than launching an unlimited retry loop.\nWhen the search has completed, review the image and decide whether a further approved adjustment is needed. If the window changes again, plan a new search and preserve the order of operations. For a proposed client test, simulate repeated user input at the interface without sending overlapping production searches. Confirm that the client queues, rejects or otherwise handles that input according to its approved design.\n\nVerification and evidence\nRetain the camera/software identity, optics identifier, intended magnification and window, sanitized request timing and each returned outcome. Have a reviewer follow the timeline and confirm that a second operation was not issued while the first was pending. Record unknown completion state explicitly instead of replacing it with an assumed success.\nPerform the separate approved image-quality acceptance after request sequencing passes. Use the required scene and recorded workflow, and preserve its result separately from the API outcome. This article proposes the sequencing exercise and does not report a camera test, a successful focus result or an application-specific completion guarantee.\nOfficial references\n\nOptics Control — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.", "content_markdown": "Bottom line: Serialize autofocus work instead of repeatedly issuing requests while a search is pending. Agree the target window and intended field of view first, then retain one search outcome before deciding whether another adjustment is necessary.\n\n## Source fact: documented behavior\n\nAxis’s [Optics Control](https://developer.axis.com/vapix/network-video/optics-control/) excludes PTZ cameras from /axis-cgi/opticscontrol.cgi and directs PTZ use to /axis-cgi/com/ptz.cgi instead.\n\nThe focus-window example warns that the optimal focus position can change after setting a window and recommends a new search afterward.\n\nThe autofocus example first sets magnification and warns that the requested search can take time and will fail if another request is initiated before completion.\n\n## What the source does not establish\n\nDo not infer a completion deadline or automatic retry policy from these examples. Obtain the exact device’s supported optics and operation information. Keep this request-sequencing check separate from acceptance of focus across the operational depth; a processed search alone must not be described as proof of useful recorded detail.\n\n## Applicability questions\n\n- Is this a supported non-PTZ optics interface on the actual camera?\n\n- Which optics identifier and intended field of view belong to the change?\n\n- What target window should the focus search use?\n\n- Which client component prevents another request while the search is pending?\n\n## DSE recommendation: controlled next steps\n\nThe following steps are DSE recommendations based on the cited source.\n\nDSE recommends treating autofocus as one pending operation with a recorded outcome before allowing another optics request.\n\n- Select an authorized pilot camera and review its available optics and capabilities. Record the existing magnification, focus window and relevant configuration through supported read operations. Agree the intended scene with the operator owner. Set the approved magnification and window through the documented workflow rather than copying example coordinates as if they described the installed view.\n\n- Start one autofocus search and have the client retain its request identity and pending state. Prevent repeated button presses or a separate automation from sending another optics request until the search outcome has been handled. Observe the documented response through the supported client workflow; do not substitute an arbitrary elapsed delay for evidence of completion. Escalate an unresolved or failed operation rather than launching an unlimited retry loop.\n\n- When the search has completed, review the image and decide whether a further approved adjustment is needed. If the window changes again, plan a new search and preserve the order of operations. For a proposed client test, simulate repeated user input at the interface without sending overlapping production searches. Confirm that the client queues, rejects or otherwise handles that input according to its approved design.\n\n## Verification and evidence\n\nRetain the camera/software identity, optics identifier, intended magnification and window, sanitized request timing and each returned outcome. Have a reviewer follow the timeline and confirm that a second operation was not issued while the first was pending. Record unknown completion state explicitly instead of replacing it with an assumed success.\n\nPerform the separate approved image-quality acceptance after request sequencing passes. Use the required scene and recorded workflow, and preserve its result separately from the API outcome. This article proposes the sequencing exercise and does not report a camera test, a successful focus result or an application-specific completion guarantee.\n\n## Official references\n\n- [Optics Control](https://developer.axis.com/vapix/network-video/optics-control/) — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings." }, "json_ld": { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://dsesecurity.com/#organization", "name": "Detection Systems & Engineering", "alternateName": "DSE Security", "url": "https://dsesecurity.com/", "logo": { "@type": "ImageObject", "url": "https://update.dsesecurity.com/assets/dse-logo-20260812.png?v=1.8.20" } }, { "@type": "Organization", "@id": "https://update.dsesecurity.com/#editorial-team", "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/", "parentOrganization": { "@id": "https://dsesecurity.com/#organization" } }, { "@type": "WebSite", "@id": "https://update.dsesecurity.com/#website", "name": "DSE Updates", "alternateName": "DSE Security Knowledge Hub", "url": "https://update.dsesecurity.com/", "inLanguage": "en-US", "publisher": { "@id": "https://dsesecurity.com/#organization" }, "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@type": "WebPage", "@id": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/", "url": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/", "isPartOf": { "@id": "https://update.dsesecurity.com/#website" }, "lastReviewed": "2026-10-29" }, { "@type": "BreadcrumbList", "@id": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/#breadcrumbs", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "DSE Updates", "item": "https://update.dsesecurity.com/" }, { "@type": "ListItem", "position": 2, "name": "Video Surveillance", "item": "https://update.dsesecurity.com/topic/video-surveillance/" }, { "@type": "ListItem", "position": 3, "name": "Wait for Axis autofocus to finish before retrying an optics request", "item": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/" } ] }, { "@type": [ "Article", "TechArticle" ], "@id": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/#article", "identifier": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/", "url": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/", "headline": "Wait for Axis autofocus to finish before retrying an optics request", "description": "Serialize Axis autofocus work: establish the target window, start one search and wait for completion before another request.", "abstract": "Serialize Axis autofocus work: establish the target window, start one search and wait for completion before another request. Keep the documented non-PTZ scope explicit.", "articleBody": "Bottom line: Serialize autofocus work instead of repeatedly issuing requests while a search is pending. Agree the target window and intended field of view first, then retain one search outcome before deciding whether another adjustment is necessary.\nSource fact: documented behavior\nAxis’s Optics Control excludes PTZ cameras from /axis-cgi/opticscontrol.cgi and directs PTZ use to /axis-cgi/com/ptz.cgi instead.\nThe focus-window example warns that the optimal focus position can change after setting a window and recommends a new search afterward.\nThe autofocus example first sets magnification and warns that the requested search can take time and will fail if another request is initiated before completion.\nWhat the source does not establish\nDo not infer a completion deadline or automatic retry policy from these examples. Obtain the exact device’s supported optics and operation information. Keep this request-sequencing check separate from acceptance of focus across the operational depth; a processed search alone must not be described as proof of useful recorded detail.\nApplicability questions\n\nIs this a supported non-PTZ optics interface on the actual camera?\nWhich optics identifier and intended field of view belong to the change?\nWhat target window should the focus search use?\nWhich client component prevents another request while the search is pending?\n\nDSE recommendation: controlled next steps\nThe following steps are DSE recommendations based on the cited source.\nDSE recommends treating autofocus as one pending operation with a recorded outcome before allowing another optics request.\n\nSelect an authorized pilot camera and review its available optics and capabilities. Record the existing magnification, focus window and relevant configuration through supported read operations. Agree the intended scene with the operator owner. Set the approved magnification and window through the documented workflow rather than copying example coordinates as if they described the installed view.\nStart one autofocus search and have the client retain its request identity and pending state. Prevent repeated button presses or a separate automation from sending another optics request until the search outcome has been handled. Observe the documented response through the supported client workflow; do not substitute an arbitrary elapsed delay for evidence of completion. Escalate an unresolved or failed operation rather than launching an unlimited retry loop.\nWhen the search has completed, review the image and decide whether a further approved adjustment is needed. If the window changes again, plan a new search and preserve the order of operations. For a proposed client test, simulate repeated user input at the interface without sending overlapping production searches. Confirm that the client queues, rejects or otherwise handles that input according to its approved design.\n\nVerification and evidence\nRetain the camera/software identity, optics identifier, intended magnification and window, sanitized request timing and each returned outcome. Have a reviewer follow the timeline and confirm that a second operation was not issued while the first was pending. Record unknown completion state explicitly instead of replacing it with an assumed success.\nPerform the separate approved image-quality acceptance after request sequencing passes. Use the required scene and recorded workflow, and preserve its result separately from the API outcome. This article proposes the sequencing exercise and does not report a camera test, a successful focus result or an application-specific completion guarantee.\nOfficial references\n\nOptics Control — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.", "datePublished": "2026-10-29T17:41:23+00:00", "dateModified": "2026-10-29T17:41:38+00:00", "mainEntityOfPage": { "@id": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/" }, "inLanguage": "en-US", "isAccessibleForFree": true, "author": { "@type": "Organization", "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/#editorial-team" }, "publisher": { "@id": "https://dsesecurity.com/#organization" }, "image": { "@type": "ImageObject", "@id": "https://update.dsesecurity.com/updates/wait-for-axis-autofocus-to-finish-before-retrying-an-optics-request/#primaryimage", "url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20", "contentUrl": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20", "width": 1200, "height": 630, "caption": "Wait for Axis autofocus to finish before retrying an optics request" }, "articleSection": [ "Video Surveillance" ], "keywords": [ "Video Surveillance", "Guide", "Advisory priority" ], "genre": "Guide", "about": [ { "@type": "Thing", "name": "Video Surveillance", "url": "https://update.dsesecurity.com/topic/video-surveillance/" } ], "wordCount": 558, "timeRequired": "PT3M", "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/", "usageInfo": "https://update.dsesecurity.com/usage/", "copyrightHolder": { "@id": "https://dsesecurity.com/#organization" }, "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.", "citation": { "@type": "CreativeWork", "name": "Axis Communications — Optics Control", "url": "https://developer.axis.com/vapix/network-video/optics-control/" } } ] } }