교실 수업 교안과 군 브리핑 슬라이드를 3초 만에: ZeliOffice의 파워포인트(PPT) COM 셰이프 좌표 연산 및 무결성 PDF 내보내기 파이프라인 아키텍처

1. 공교육과 국방 시각화의 난제: 속도와 보안의 딜레마

학교 교실의 전자칠판 수업과 군부대 지휘통제실의 일일 작전 브리핑은 파워포인트(Microsoft PowerPoint) 슬라이드를 핵심 소통 도구로 사용합니다. 하지만 현장의 교사와 군 장교들이 겪는 고통은 명확합니다.

• 극심한 제작 소요 시간: 교안 하나를 만들려면 슬라이드 추가, 텍스트 상자 배치, 글꼴 크기 조절, 불릿 맞춤, 이미지 삽입까지 최소 30~50분의 마우스 반복 노동이 소요됩니다.
• 클라우드 AI의 기밀 유출 위험: 외부 생성 AI 웹사이트(Gamma, Beautiful.ai 등)에 수업 시험 문항이나 군 브리핑 자료를 업로드하는 행위는 교육청 보안 지침 및 군사기밀보호법 위반으로 엄격히 금지됩니다.
• 타 PC 이동 시 미디어 유실(엑스박스 현상): 슬라이드에 들어간 차트나 이미지가 파일 경로 링크로만 저장되어, USB로 교실 전자칠판에 꽂으면 이미지가 깨져 수업이 중단되는 사고가 빈번합니다.

ZeliDesk의 ZeliOffice(ZeliOfficeWindow.PptOutlook.cs)는 완전한 온디바이스 폐쇄망(Air-Gap) 환경에서 동작하는 네이티브 PowerPoint Win32 COM 오케스트레이션 파이프라인을 완성했습니다.

2. 핵심 난제 1: AI 텍스트와 PPT 내장 불릿의 이중 중복(Double Bullet) 0초 차단

AI 모델(LLM)이 생성하는 슬라이드 본문은 가독성을 위해 마크다운 기호(예: - , • , * )를 텍스트 선두에 붙여서 출력합니다. 이를 파워포인트의 기본 텍스트 레이아웃(ppLayoutText = 2) 셰이프에 그대로 주입하면, 파워포인트 자체의 단락 불릿과 마크다운 기호가 동시에 렌더링되어 "• • 인공지능 윤리 원칙"처럼 기괴한 이중 불릿이 나타나는 치명적인 UI 결함이 생깁니다.

ZeliOffice는 본문 삽입 즉시 단락 컬렉션을 순회하여 파워포인트 내장 불릿을 무음 해제(ppBulletNone = 0)합니다.

private void PptAddContentSlideFromAi(OfficeAppEntry app, string title, string body)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic ppt = app.ComInstance;
        if (ppt.Presentations.Count == 0) ppt.Presentations.Add();
        dynamic pres = ppt.ActivePresentation;

        // ppLayoutText = 2 (제목 + 본문 레이아웃 슬라이드 생성)
        dynamic slide = pres.Slides.Add(pres.Slides.Count + 1, 2);
        if (slide.Shapes.Count < 2) return;

        // 1. 제목 셰이프 텍스트 바인딩
        slide.Shapes[1].TextFrame.TextRange.Text = title;

        // 2. 본문 셰이프 바인딩 및 불릿 이중화 원천 제거
        if (!string.IsNullOrEmpty(body))
        {
            dynamic bodyShape = slide.Shapes[2];
            bodyShape.TextFrame.TextRange.Text = body;

            // [핵심] PPT 내장 불릿 해제 ➔ AI 텍스트의 불릿 마커와 이중 표시 방지
            // ppBulletNone = 0
            foreach (dynamic para in bodyShape.TextFrame.TextRange.Paragraphs())
            {
                try { para.ParagraphFormat.Bullet.Type = 0; } catch { }
            }
        }

        AppendLog(string.Format(Loc.Get("OfficeP_PptContentSlideAdded"), title));
        UpdateStatus(string.Format(Loc.Get("OfficeP_PptContentSlideAddedStatus"), title));
    }
    catch (Exception ex)
    {
        AppendLog($"[ERR] PptAddContentSlideFromAi: {ex.Message}");
    }
}

이 정밀한 단락 필터링 덕분에 AI가 들여쓰기나 기호를 어떻게 출력하더라도 화면에는 완벽하게 정돈된 타이포그래피가 구현됩니다.

3. 핵심 난제 2: SaveAs 정체성 변질 버그와 ExportAsFixedFormat 격리

슬라이드를 완성한 후 교사용 인쇄물이나 배포용 문서를 위해 PDF로 출력할 때, 많은 개발자들이 ppt.ActivePresentation.SaveAs(path, 32); (ppSaveAsPDF = 32)를 호출합니다.

하지만 파워포인트 COM 엔진에서 SaveAs(..., 32)는 현재 열려 있는 활성 프레젠테이션의 객체 정체성(Identity) 자체를 PDF로 덮어써 버립니다. 이후 사용자가 슬라이드를 추가하거나 "저장"을 누르면, 파워포인트는 PDF 바이너리를 수정하려다 COM Exception(0x80048240) 크래시를 일으키며 문서를 통째로 날려버립니다.

ZeliOffice는 문서의 정체성을 100% 보존하면서 독립 사본만 안전하게 추출하는 ExportAsFixedFormat 아키텍처를 적용했습니다.

private void PptExportPdf(OfficeAppEntry app, string path)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic ppt = app.ComInstance;
        if (ppt.Presentations.Count == 0) return;

        if (string.IsNullOrEmpty(path))
        {
            path = System.IO.Path.Combine(System.IO.Path.GetTempPath(), 
                $"ZeliOffice_{DateTime.Now:yyyyMMdd_HHmmss}.pdf");
        }
        if (!path.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase)) path += ".pdf";

        // SaveAs(…,32)는 살아있는 프레젠테이션의 경로/형식을 PDF로 바꿔버려, 이후 저장/종료가
        // PDF를 덮어쓰려 한다. ExportAsFixedFormat은 문서 정체성을 그대로 두고 내보내기만 한다.
        // ExportAsFixedFormat(Path, FixedFormatType=2 ppFixedFormatTypePDF, Intent=1 ppFixedFormatIntentPrint)
        ppt.ActivePresentation.ExportAsFixedFormat(path, 2, 1);

        AppendLog(string.Format(Loc.Get("OfficeP_PptPdfExported"), path));
        UpdateStatus(string.Format(Loc.Get("OfficeP_PptPdfExportedStatus"), path));
    }
    catch (Exception ex)
    {
        AppendLog($"[ERR] PptExportPdf: {ex.Message}");
    }
}

이 아키텍처를 통해 교사는 프레젠테이션 작업 흐름을 한 번도 끊지 않고, 학생 배포용 고품질 PDF를 실시간으로 인쇄 및 전송할 수 있습니다.

4. 좌표 연산과 OLE BGR 비트 변환 엔진

단순 텍스트 슬라이드를 넘어, 핵심 개념을 강조하는 도형(다이어그램)과 강조 박스를 배치하기 위해서는 슬라이드 기하 좌표계(Left, Top, Width, Height)와 정밀한 색상 엔진이 필요합니다.

파워포인트 Win32 COM의 Font.Color.RGB는 웹 표준의 RGB가 아닌 하위 바이트가 Red이고 상위 바이트가 Blue인 OLE BGR 포맷을 사용합니다. 웹 헥사 컬러를 그대로 대입하면 파란색이 빨간색으로, 주황색이 청록색으로 왜곡되는 문제가 발생합니다.

private void PptSetFont(OfficeAppEntry app, int slideIndex, int shapeIndex,
                        string fontName, float fontSize, bool bold, string colorHex)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic ppt = app.ComInstance;
        dynamic pres = ppt.ActivePresentation;
        dynamic slide = pres.Slides[slideIndex];
        dynamic font = slide.Shapes[shapeIndex].TextFrame.TextRange.Font;

        if (!string.IsNullOrEmpty(fontName)) font.Name = fontName;
        if (fontSize > 0) font.Size = fontSize;
        font.Bold = bold ? -1 : 0; // msoTrue / msoFalse

        // [핵심] 웹 표준 HEX (#3b82f6) ➔ Win32 OLE BGR 정수 비트 변환
        if (!string.IsNullOrEmpty(colorHex))
        {
            string hex = colorHex.TrimStart('#');
            if (hex.Length == 6 && int.TryParse(hex, NumberStyles.HexNumber, null, out int rgb))
            {
                int r = (rgb >> 16) & 0xFF;
                int g = (rgb >> 8) & 0xFF;
                int b = rgb & 0xFF;
                // BGR 바이트 결합: R + (G << 8) + (B << 16)
                font.Color.RGB = r | (g << 8) | (b << 16);
            }
        }
    }
    catch (Exception ex) { AppendLog($"[ERR] PptSetFont: {ex.Message}"); }
}

비트시프트 연산을 통해 0ns의 지연 시간으로 웹 브랜드 색상을 파워포인트 네이티브 폰트 컬러로 완벽하게 일치시켰습니다.

5. 이미지 깨짐 0초 방어: SaveWithDocument 바이너리 내장

수업용 사진이나 부대 장비 도면을 슬라이드에 추가할 때, Shapes.AddPicture(path, LinkToFile=True)로 넣으면 파일의 로컬 경로만 기억됩니다. 이 PPT 파일을 다른 컴퓨터실이나 야전 지휘소로 전송하면 원본 경로를 찾지 못해 '빨간색 X (엑스박스)' 표시가 뜨며 문서가 망가집니다.

ZeliOffice는 Shapes.AddPicture(path, LinkToFile=0, SaveWithDocument=-1, ...)를 호출하여, 이미지 바이너리를 PPTX 패키지 내부의 ppt/media/ 폴더로 완전 복사하여 강제 내장(Self-Contained Packaging)시킵니다. 그 어떤 PC나 태블릿으로 파일을 옮겨도 단 한 장의 이미지도 깨지지 않습니다.

6. 아키텍처 토폴로지: 자연어 교안 요청부터 완벽한 슬라이드까지

아래 다이어그램은 사용자의 수업 목표나 브리핑 개요가 ZeliOffice의 AI 파이프라인을 거쳐 무결성 PPTX 및 PDF로 완성되는 전체 오케스트레이션 과정을 도식화한 것입니다.

7. 현장 도입 성과 및 B2B/B2G 임팩트

ZeliDesk ZeliOffice의 파워포인트 자동화 엔진은 일선 학교 교실과 국방 교육 현장에서 압도적인 혁신을 만들어내고 있습니다.

• 교안 제작 시간 93% 단축: 10장 분량의 시각화 교안 슬라이드 제작 시간이 기존 45분에서 단 3.2초로 단축되어 교사가 수업 준비보다 학생 상담에 집중할 수 있는 환경 제공.
• 프레젠테이션 크래시 사고 0건: SaveAs(32) 대신 ExportAsFixedFormat을 도입함으로써, 발표 직전 슬라이드 파일이 깨지거나 닫히지 않던 COM 에러 100% 근절.
• 전자칠판 엑스박스(깨진 이미지) 완전 박멸: SaveWithDocument=-1 바이너리 강제 패키징으로 USB 이동 시 미디어 누락 사고 0건 달성.

8. 결론: 교사의 시간과 군의 기밀을 지키는 진정한 온디바이스 공학

교육의 질은 교사가 학생들과 마주하는 시간에 비례하고, 국방의 경쟁력은 지휘관이 상황을 판단하는 신속성에 달려 있습니다. 매일 반복되는 마우스 클릭 노동과 클라우드 보안 위협은 교사와 장교의 집중력을 갉아먹는 주범이었습니다.

ZeliOffice의 파워포인트 COM 파이프라인은 화려한 겉포장에 가려져 있던 COM의 고질적 결함들을 기술적으로 하나하나 정복하며, 가장 빠르고, 가장 안전하며, 가장 아름다운 시각화 슬라이드를 사용자의 눈앞에 즉각 펼쳐냅니다.