# Tworzenie efektów 3D w prezentacjach przy użyciu C++ > Zastosuj i renderuj efekty 3D dla kształtów i tekstu PowerPoint w C++ przy użyciu Aspose.Slides. Konfiguruj kamerę, oświetlenie, materiał, ekstruzję, wypełnienia i tekst 3D. Source: https://docs.aspose.com/slides/pl/cpp/3d-presentation/ Updated: 2026-06-11 ## **Przegląd** Aspose.Slides for C++ może tworzyć, edytować, zachowywać i renderować formatowanie 3D w stylu PowerPoint dla kształtów i tekstu. Ten artykuł opisuje efekty 3D, takie jak obrót, ekstruzję, fazowanie, oświetlenie, materiał, wypełnienia gradientowe lub obrazowe oraz tekst 3D. {{% alert color="primary" %}} Ten artykuł dotyczy efektów formatowania 3D na kształtach i tekście w PowerPoint. Nie dotyczy wstawiania ani edytowania oddzielnych plików modeli 3D. Gdy eksportujesz slajd do obrazu, PDF lub HTML, Aspose.Slides renderuje te efekty 3D w wyjściowym 2D. {{% /alert %}} ## **Koncepcje formatowania 3D** Użyj metody [get_ThreeDFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ishape/get_threedformat/) interfejsu [IShape](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ishape/), aby zastosować formatowanie 3D do kształtu. Metoda zwraca [IThreeDFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/), które kontroluje scenę 3D dla tego kształtu. Dla tekstu użyj metody [get_ThreeDFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/itextframeformat/get_threedformat/) interfejsu [ITextFrameFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/itextframeformat/). To stosuje formatowanie 3D do ramki tekstu, a nie do ciała kształtu. Najważniejsze metody to: | Metoda | Co kontroluje | Kiedy używać | |---|---|---| | [get_Camera](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_camera/) | Punkt widzenia, predefiniowany typ kamery, obrót, powiększenie i perspektywa. | Obróć obiekt w przestrzeni 3D lub dopasuj do predefiniowanego obrotu 3D w PowerPoint. | | [get_LightRig](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_lightrig/) | Predefiniowane oświetlenie, kierunek i obrót światła. | Zmień sposób, w jaki podświetlenia i cienie pojawiają się na powierzchni 3D. | | [set_Material](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/set_material/) | Materiał powierzchni, np. płaski, matowy, plastikowy lub metalowy. | Spraw, by ta sama geometria wyglądała bardziej płasko, miękko, błyszcząco lub metalicznie. | | [set_ExtrusionHeight](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/set_extrusionheight/) | Jak daleko kształt rozciąga się w tył od swojej przedniej powierzchni. | Zamień płaski kształt w widocznie gruby obiekt 3D. | | [get_ExtrusionColor](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_extrusioncolor/) | Kolor wyciągniętych boków. | Uczyń głębokość widoczną lub dopasuj kolor boków do wypełnienia frontu. | | [set_Depth](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/set_depth/) | Dodatkowa głębokość 3D używana przez formatowanie 3D w PowerPoint. | Dostrój głębokość kształtów lub tekstu, szczególnie w połączeniu z ustawieniami fazy i materiału. | | [get_BevelTop](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_beveltop/) i [get_BevelBottom](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_bevelbottom/) | Podniesione lub zaokrąglone krawędzie na przednich i tylnych powierzchniach. | Dodaj złagodzone lub formowane krawędzie zamiast ostrej płaskiej powierzchni. | | [get_ContourColor](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_contourcolor/) i [set_ContourWidth](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/set_contourwidth/) | Obrys wokół obiektu 3D. | Podkreśl granicę obiektu w renderowanym wyniku. | ## **Utworzenie kształtu 3D** Zwykle kształt wymaga czterech rodzajów ustawień, aby wyglądał przekonująco 3D: - Ustawienia kamery, ponieważ domyślny widok przedni może ukrywać ekstruzję. - Ustawienia oświetlenia, ponieważ oświetlenie sprawia, że powierzchnie i boki są widoczne. - Ustawienia materiału, ponieważ powierzchnia wpływa na sposób renderowania światła. - Ustawienia ekstruzji lub głębokości, ponieważ płaski kształt potrzebuje grubości. Poniższy przykład tworzy prostokąt, dodaje tekst do jego przedniej powierzchni, stosuje formatowanie 3D, zapisuje prezentację jako PPTX i renderuje slajd do obrazu PNG. ```cpp const float imageScale = 2.0f; auto presentation = System::MakeObject(); auto slide = presentation->get_Slide(0); auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 200.0f, 200.0f); shape->get_TextFrame()->set_Text(u"3D"); shape->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(64.0f); auto frontColor = System::Drawing::Color::get_CornflowerBlue(); shape->get_FillFormat()->set_FillType(FillType::Solid); shape->get_FillFormat()->get_SolidFillColor()->set_Color(frontColor); auto extrusionColor = System::Drawing::Color::get_Blue(); shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront); shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f); shape->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Flat); shape->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top); shape->get_ThreeDFormat()->set_Material(MaterialPresetType::Flat); shape->get_ThreeDFormat()->set_ExtrusionHeight(100.0); shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor); auto thumbnail = slide->GetImage(imageScale, imageScale); thumbnail->Save(u"shape_3d.png"); thumbnail->Dispose(); presentation->Save(u"shape_3d.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Renderowany obraz slajdu pokazuje prostokąt jako gruby blok 3D: ![Renderowany niebieski prostokąt 3D z białym tekstem 3D na przedniej powierzchni](img_01_01.png) ## **Obrócenie kształtu przy użyciu kamery** W PowerPoint rotacja 3D jest konfigurowana w panelu Obrót 3D. Wartości rotacji X, Y i Z odpowiadają rotacji ustawionej za pośrednictwem API kamery. ![Panel Obrót 3D w PowerPoint z podświetlonymi wartościami rotacji X, Y i Z](img_02_01.png) W Aspose.Slides ustaw typ kamery i rotację za pomocą [IThreeDFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/): ```cpp shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront); shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f); ``` Użyj kamery, gdy potrzebujesz zmienić sposób, w jaki widz widzi obiekt. Nie zmienia ona geometrii kształtu 2D na slajdzie. Zmienia punkt widzenia 3D używany przez PowerPoint i przez Aspose.Slides podczas renderowania. ## **Dodanie ekstruzji i głębokości** Ekstruzja sprawia, że kształt wygląda na gruby, wydłużając go za przednią powierzchnię. W PowerPoint kontrolka głębokości ustawia tę widoczną grubość, a kontrolka koloru ustawia kolor boków. ![Kontrolki głębokości w PowerPoint powiązane z właściwościami koloru ekstruzji i wysokości ekstruzji](img_02_02.png) Ustaw [set_ExtrusionHeight](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/set_extrusionheight/) dla grubości i [get_ExtrusionColor](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/get_extrusioncolor/) dla koloru boków: ```cpp shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f); shape->get_ThreeDFormat()->set_ExtrusionHeight(100.0); auto extrusionColor = System::Drawing::Color::get_Purple(); shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor); ``` Użyj [set_Depth](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ithreedformat/set_depth/) gdy potrzebujesz pracować bezpośrednio z wartością głębokości w PowerPoint lub łączyć głębokość z fazą, materiałem i efektami tekstu. W wielu scenariuszach kształtów `set_ExtrusionHeight` jest bardziej przejrzystym ustawieniem, ponieważ bezpośrednio określa widoczną ekstruzję. ## **Użycie wypełnień gradientowych lub obrazowych z efektami 3D** Formatowanie 3D jest niezależne od wypełnienia kształtu. Możesz zastosować jednolity kolor, gradient, wzór lub wypełnienie obrazem na przedniej powierzchni i nadal używać tych samych ustawień kamery, światła, materiału i ekstruzji. Ten przykład stosuje wypełnienie gradientowe do kształtu i ciemniejszy kolor ekstruzji na bokach: ```cpp const float imageScale = 2.0f; auto presentation = System::MakeObject(); auto slide = presentation->get_Slide(0); auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 250.0f, 250.0f); shape->get_TextFrame()->set_Text(u"3D Gradient"); shape->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(64.0f); auto firstGradientColor = System::Drawing::Color::get_Blue(); auto secondGradientColor = System::Drawing::Color::get_Orange(); shape->get_FillFormat()->set_FillType(FillType::Gradient); shape->get_FillFormat()->get_GradientFormat()->get_GradientStops()->Add(0.0f, firstGradientColor); shape->get_FillFormat()->get_GradientFormat()->get_GradientStops()->Add(100.0f, secondGradientColor); auto extrusionColor = System::Drawing::Color::get_DarkOrange(); shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront); shape->get_ThreeDFormat()->get_Camera()->SetRotation(10.0f, 20.0f, 30.0f); shape->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Flat); shape->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top); shape->get_ThreeDFormat()->set_Material(MaterialPresetType::Flat); shape->get_ThreeDFormat()->set_ExtrusionHeight(150.0); shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor); auto thumbnail = slide->GetImage(imageScale, imageScale); thumbnail->Save(u"gradient_3d.png"); thumbnail->Dispose(); presentation->Dispose(); ``` Renderowany wynik zachowuje gradient na przedniej powierzchni i renderuje ekstruzję osobno: ![Renderowany prostokąt 3D z wypełnieniem gradientowym od niebieskiego do pomarańczowego i pomarańczową ekstruzją](img_02_03.png) Aby użyć wypełnienia obrazem, dodaj obraz do prezentacji i przypisz go jako wypełnienie kształtu: ```cpp auto imageData = System::IO::File::ReadAllBytes(u"image.jpg"); auto image = presentation->get_Images()->AddImage(imageData); shape->get_FillFormat()->set_FillType(FillType::Picture); shape->get_FillFormat()->get_PictureFillFormat()->get_Picture()->set_Image(image); shape->get_FillFormat()->get_PictureFillFormat()->set_PictureFillMode(PictureFillMode::Stretch); auto extrusionColor = System::Drawing::Color::get_DarkOrange(); shape->get_ThreeDFormat()->get_Camera()->SetRotation(10.0f, 20.0f, 30.0f); shape->get_ThreeDFormat()->set_ExtrusionHeight(150.0); shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor); ``` Obraz jest renderowany na przedniej powierzchni, podczas gdy ekstruzja jest renderowana jako 3D powierzchnia boczna: ![Renderowany prostokąt 3D z wypełnieniem zdjęciem na przedniej powierzchni i pomarańczową ekstruzją](img_02_04.png) ## **Zastosowanie formatowania 3D do tekstu** Formatowanie 3D kształtu wpływa na ciało kształtu. Formatowanie 3D tekstu wpływa na ramkę tekstu. Jest to przydatne dla efektów podobnych do WordArt, gdzie same litery wymagają ekstruzji, materiału, oświetlenia i ustawień kamery. Następny przykład tworzy tekst z wypełnieniem wzorem, stosuje transformację WordArt i konfiguruje ustawienia 3D na [ITextFrameFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/itextframeformat/): ```cpp const float imageScale = 2.0f; auto presentation = System::MakeObject(); auto slide = presentation->get_Slide(0); auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 250.0f, 250.0f); shape->get_FillFormat()->set_FillType(FillType::NoFill); shape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::NoFill); shape->get_TextFrame()->set_Text(u"3D Text"); auto portion = shape->get_TextFrame()->get_Paragraph(0)->get_Portion(0); portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Pattern); auto foregroundColor = System::Drawing::Color::get_DarkOrange(); auto backgroundColor = System::Drawing::Color::get_White(); portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->get_ForeColor()->set_Color(foregroundColor); portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->get_BackColor()->set_Color(backgroundColor); portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->set_PatternStyle(PatternStyle::LargeGrid); shape->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(128.0f); auto textFrameFormat = shape->get_TextFrame()->get_TextFrameFormat(); textFrameFormat->set_Transform(TextShapeType::ArchUp); textFrameFormat->get_ThreeDFormat()->set_ExtrusionHeight(3.5); textFrameFormat->get_ThreeDFormat()->set_Depth(3.0); textFrameFormat->get_ThreeDFormat()->set_Material(MaterialPresetType::Plastic); textFrameFormat->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top); textFrameFormat->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Balanced); textFrameFormat->get_ThreeDFormat()->get_LightRig()->SetRotation(0.0f, 0.0f, 40.0f); textFrameFormat->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::PerspectiveContrastingRightFacing); auto thumbnail = slide->GetImage(imageScale, imageScale); thumbnail->Save(u"text_3d.png"); thumbnail->Dispose(); presentation->Save(u"text_3d.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Tekst jest renderowany jako zakrzywione, ekstruzowane litery 3D: ![Renderowany tekst 3D z zakrzywioną transformacją WordArt, pomarańczowym wypełnieniem wzorem i ciemną ekstruzją](img_02_05.png) ## **Zachowanie przy eksporcie i renderowaniu** Aspose.Slides zachowuje formatowanie 3D podczas zapisywania w formatach PowerPoint, takich jak PPTX. Podczas renderowania lub eksportu do formatów o stałym układzie scena 3D jest rastrowana lub rysowana w wyjściu jako wynik 2D. Dotyczy to renderowania slajdów do [PNG](/slides/pl/cpp/convert-powerpoint-to-png/), eksportu do [PDF](/slides/pl/cpp/convert-powerpoint-to-pdf/), eksportu do [HTML](/slides/pl/cpp/convert-powerpoint-to-html/), lub generowania klatek do [video conversion](/slides/pl/cpp/convert-powerpoint-to-video/). Pamiętaj o następujących punktach: - Wyeksportowane obrazy i pliki PDF nie są interaktywne. Obiekt nie może być obracany przez widza po eksporcie. - Ostateczny wygląd zależy od kombinacji kamery, zestawu świateł, materiału, ekstruzji, wypełnienia i skalowania slajdu. - Jeśli potrzebujesz sprawdzić dziedziczone lub oparte na temacie wartości formatowania, przeczytaj [efektywne właściwości kształtu](/slides/pl/cpp/shape-effective-properties/). - Niektóre formaty wyjściowe nie mogą przechowywać edytowalnego formatowania 3D PowerPoint. W tych formatach wynik wizualny jest renderowany, a nie zachowywany jako edytowalne ustawienia 3D. ## **FAQ** **Czy Aspose.Slides może tworzyć interaktywne prezentacje 3D?** Aspose.Slides tworzy i renderuje efekty 3D PowerPoint dla kształtów i tekstu. Nie tworzy interaktywnych scen 3D w wyeksportowanych obrazach, PDF‑ach ani stronach HTML, które widz mógłby obracać. W PPTX formatowanie 3D pozostaje edytowalne w PowerPoint, o ile format to obsługuje. **Jaka jest różnica między modelem 3D a efektem 3D?** Model 3D to oddzielny obiekt 3D wstawiany do prezentacji. Efekt 3D to formatowanie zastosowane do zwykłego kształtu lub tekstu w PowerPoint, takie jak obrót, ekstruzja, fazowanie, oświetlenie i materiał. Ten artykuł opisuje efekty 3D. **Jakie ustawienia są wymagane, aby kształt 3D był widoczny?** Co najmniej ustaw rotację kamery oraz ekstruzję lub głębokość. W praktyce warto również ustawić zestaw świateł i materiał, aby renderowane powierzchnie miały wyraźne podświetlenia i cienie. **Czy mogę zastosować efekty 3D zarówno do kształtów, jak i tekstu?** Tak. Użyj [IShape](https://reference.aspose.com/slides/pl/cpp/aspose.slides/ishape/) dla ciała kształtu oraz [ITextFrameFormat](https://reference.aspose.com/slides/pl/cpp/aspose.slides/itextframeformat/) dla tekstu. **Czy efekty 3D pojawią się przy eksporcie do obrazów, PDF, HTML lub klatek wideo?** Tak. Aspose.Slides renderuje efekty 3D przy tworzeniu obrazów slajdów, wyjścia PDF, wyjścia HTML i klatek używanych do konwersji wideo. Wyeksportowany plik zawiera renderowany wygląd, a nie edytowalny obiekt 3D. **Czy mogę odczytać ostateczne wartości 3D po zastosowaniu dziedziczenia i ustawień tematu?** Tak. Użyj interfejsów API formatowania efektywnego opisanych w [Właściwości efektywne kształtu](/slides/pl/cpp/shape-effective-properties/), aby odczytać ostateczne wartości kamery, zestawu świateł, fazowania i powiązane wartości 3D.