পৃষ্ঠা, পৃষ্ঠা উপাদান, এবং বৈশিষ্ট্য

স্লাইডস এপিআই কার্যকরভাবে ব্যবহার করার জন্য, আপনাকে উপস্থাপনা এবং তাদের উপাদানগুলির আর্কিটেকচার এবং সেইসাথে এই উপাদানগুলির মধ্যে মিথস্ক্রিয়া বুঝতে হবে। এই পৃষ্ঠাটি এই বিষয়গুলির একটি বিশদ ওভারভিউ প্রদান করে:

• উপস্থাপনা উপাদানের ধারণাগত মডেল
• এপিআই কীভাবে এই উপাদানগুলিকে উপস্থাপন করে
• উপাদানের স্টাইলিং বৈশিষ্ট্য

এটি এবং অন্যান্য ধারণার ওভারভিউগুলি পড়া কীভাবে নির্দেশিকা , রেফারেন্স ডকুমেন্টেশন এবং রেসিপির নমুনাগুলি বোঝা এবং ব্যবহার করা সহজ করে তুলবে৷

উপস্থাপনা, পৃষ্ঠা এবং পৃষ্ঠা উপাদান

Google স্লাইডের সবচেয়ে বাইরের ধারক উপাদান হল একটি উপস্থাপনা । এটি এমন একক যা Google ড্রাইভে সংরক্ষণ করা যায়, অন্যান্য ব্যবহারকারীদের সাথে ভাগ করা যায় এবং আরও অনেক কিছু।

প্রতিটি উপস্থাপনায় বিভিন্ন ধরনের পৃষ্ঠা থাকে। এক ধরনের পৃষ্ঠা হল একটি স্লাইড , যেগুলি এমন পৃষ্ঠা যা ব্যবহারকারীরা দেখতে পান এবং যখন একটি স্ক্রিনে উপস্থাপনা রেন্ডার করা হয় তখন এর মধ্যে ফ্লিপ করে৷

প্রতিটি পৃষ্ঠায় অনেকগুলি পৃষ্ঠা উপাদান রয়েছে, যা একসাথে পৃষ্ঠার বিষয়বস্তু তৈরি করে, যেমনটি নিম্নলিখিত চিত্রে দেখানো হয়েছে:

স্লাইডগুলি ছাড়াও, অন্যান্য ধরণের পৃষ্ঠা রয়েছে যা আপনাকে বিভিন্ন স্লাইডে নকশা প্রয়োগ করতে দেয়, একটি সামঞ্জস্যপূর্ণ চেহারা তৈরি করে৷ এই অন্যান্য পৃষ্ঠার ধরনগুলি হল মাস্টার এবং লেআউট , এবং তাদের বৈশিষ্ট্যগুলি নির্ধারণ করে যে স্লাইডগুলি কীভাবে রেন্ডার করা হয়, নিম্নলিখিত চিত্রে দেখানো হয়েছে:

মাস্টার্স — মাস্টার পৃষ্ঠা দুটি উদ্দেশ্য পরিবেশন করে। মাস্টারের প্লেসহোল্ডারগুলিতে আপনার উপস্থাপনা জুড়ে ব্যবহৃত পাঠ্য শৈলীগুলির জন্য ডিফল্ট রয়েছে। মাস্টার স্লাইডে ব্যাকগ্রাউন্ড এবং অন্য কোন আকার সেই মাস্টারের উপর ভিত্তি করে সমস্ত স্লাইডের জন্য ডিফল্ট ব্যাকগ্রাউন্ড তৈরি করে। আপনার যদি একটি কোম্পানির লোগো থাকে যা আপনি আপনার উপস্থাপনার প্রতিটি স্লাইডে প্রদর্শিত হতে চান, তাহলে এটি মাস্টারের উপর রাখুন।

লেআউটস — লেআউট টেমপ্লেটগুলি নির্ধারণ করে কিভাবে প্রতিটি ধরনের স্লাইডে বিষয়বস্তু সাজানো হয়। আপনি যদি আপনার সমস্ত শিরোনাম স্লাইডগুলিকে একটি নির্দিষ্ট উপায়ে দেখতে চান, উদাহরণস্বরূপ, আপনি শিরোনাম বিন্যাস টেমপ্লেটটি সম্পাদনা করতে পারেন৷

আরও দুটি ধরণের পৃষ্ঠা রয়েছে - নোট পৃষ্ঠা এবং নোট মাস্টার - যেগুলি বেশিরভাগই স্পিকার নোটগুলির সাথে কাজ করার জন্য প্রাসঙ্গিক৷

API প্রতিনিধিত্ব প্রকার এবং গঠন

এই বিভাগটি বর্ণনা করে যে Google স্লাইডের ধারণাগত মডেল, উপরে বর্ণিত হিসাবে, স্লাইড API-এ কীভাবে উপস্থাপন করা হয়।

নিম্নলিখিত চিত্রটি উপস্থাপনা, পৃষ্ঠা এবং পৃষ্ঠা উপাদানগুলির মধ্যে সম্পর্ককে স্লাইড এপিআই-এর প্রকার হিসাবে চিত্রিত করে:

নিম্নলিখিত বিভাগগুলি দেখায় যে এই ধরনের JSON-এ কীভাবে উপস্থাপন করা হয়।

উপস্থাপনা

একটি উপস্থাপনায় বেশ কয়েকটি বৈশিষ্ট্য অন্তর্ভুক্ত থাকে এবং এতে যে পৃষ্ঠাগুলি রয়েছে তা রয়েছে:

{
  "presentationId": string,
  "pageSize": { object(Size) },
  "slides": [ { object(Page) } ],
  "title": string,
  "masters": [ { object(Page) } ],
  "layouts": [ { object(Page) } ],
  "notesMaster": object(Page),
  "locale": string,
}

পাতা

একটি পৃষ্ঠা বৈশিষ্ট্যগুলির একটি সেট অন্তর্ভুক্ত করে এবং এতে পৃষ্ঠার উপাদানগুলি রয়েছে:

{
  "objectId": string,
  "pageType": enum(PageType),
  "pageElements": [ { object(PageElement) } ],
  "pageProperties": { object(PageProperties) },

  // Union field properties can be only one of the following:
  "slideProperties": { object(SlideProperties) },
  "layoutProperties": { object(LayoutProperties) },
  "notesProperties": { object(NotesProperties) },
  // End of list of possible types for union field properties.
}

পৃষ্ঠা উপাদান

পৃষ্ঠা উপাদানগুলি হল চাক্ষুষ উপাদান যা পৃষ্ঠাগুলিতে স্থাপন করা হয়। এপিআই-এর একটি পৃষ্ঠা উপাদানে অনেকগুলি বৈশিষ্ট্য রয়েছে, যার মধ্যে একটি ক্ষেত্র রয়েছে যা পৃষ্ঠার উপাদানের ধরন অনুসারে পরিবর্তিত হয়:

{
  "objectId": string,
  "size": { object(Size) },
  "transform": { object(AffineTransform) },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": { object(Group) },
  "shape": { object(Shape) },
  "image": { object(Image) },
  "video": { object(Video) },
  "line": { object(Line) },
  "table": { object(Table) },
  "wordArt": { object(WordArt) },
  "sheetsChart": { object(SheetsChart) },
  // End of list of possible types for union field element_kind.
}

উপরের সংজ্ঞায় ইউনিয়ন ক্ষেত্র element_kind দ্বারা সংজ্ঞায়িত হিসাবে বিভিন্ন ধরণের পৃষ্ঠা উপাদান রয়েছে। এই ধরণের পৃষ্ঠা উপাদানগুলি নিম্নলিখিত টেবিলে বর্ণনা করা হয়েছে:

উপাদান ধরনের	বর্ণনা
গ্রুপ	পৃষ্ঠা উপাদানগুলির একটি সেট যা একটি পৃথক ইউনিট হিসাবে বিবেচিত হয়। এগুলি একসাথে সরানো, স্কেল করা এবং ঘোরানো যায়।
আকৃতি	একটি সরল চাক্ষুষ বস্তু, যেমন আয়তক্ষেত্র, উপবৃত্ত এবং পাঠ্য বাক্স। আকারে পাঠ্য থাকতে পারে, তাই স্লাইডগুলি তৈরি করার জন্য এগুলি সবচেয়ে সাধারণ পৃষ্ঠা উপাদান।
ছবি	একটি গ্রাফিক স্লাইডে আমদানি করা হয়েছে৷
ভিডিও	একটি ভিডিও স্লাইডে আমদানি করা হয়েছে৷
লাইন	একটি ভিজ্যুয়াল লাইন, বক্ররেখা বা সংযোগকারী।
টেবিল	বিষয়বস্তুর একটি গ্রিড।
শব্দ শিল্প	একটি ভিজ্যুয়াল টেক্সট উপাদান যা আকৃতির মতো আচরণ করে।
শীটচার্ট	Google পত্রক থেকে স্লাইডে আমদানি করা একটি চার্ট৷

পৃষ্ঠা এবং পৃষ্ঠা উপাদান বৈশিষ্ট্য

স্লাইড API আপনাকে আপনার উপস্থাপনায় পৃষ্ঠা এবং পৃষ্ঠা উপাদানগুলির উপস্থিতি পড়তে এবং আপডেট করতে দেয়৷ বিভিন্ন পৃষ্ঠার উপাদান বিভিন্ন বৈশিষ্ট্য সমর্থন করে যা পৃষ্ঠার উপাদান কীভাবে রেন্ডার করা হয় তা নিয়ন্ত্রণ করে।

প্রতিটি পৃষ্ঠা উপাদান ধরনের একটি সংশ্লিষ্ট বৈশিষ্ট্য উপাদান এবং একটি বৈশিষ্ট্য আপডেট বার্তা আছে, উদাহরণস্বরূপ:

• একটি পৃষ্ঠা উপাদান টাইপ আকার আছে
• এর সম্পত্তি ক্ষেত্র হল shapeProperties
• এই বৈশিষ্ট্যগুলি আপডেট করার অনুরোধটি হল UpdateShapePropertiesRequest

উপাদান/বৈশিষ্ট্য/আপডেট অনুরোধের একই সেট প্রতিটি পৃষ্ঠার উপাদান প্রকারের জন্য বিদ্যমান: Image / imageProperties / UpdateImageProperties ইত্যাদি।

একটি উপাদান পড়ার সময় আপনি যেখানেই এটির সম্মুখীন হন সেখানে আপনি বৈশিষ্ট্য বৈশিষ্ট্যটি পড়তে পারেন; এটির মানগুলি পরিবর্তন করতে, এটিকে ব্যাচআপডেট পদ্ধতির জন্য পেলোড হিসাবে ম্যাচিং অনুরোধের প্রকারের সাথে ব্যবহার করুন, আপনাকে উপস্থাপনায় এই মানগুলি পরিবর্তন করতে দেয়।

বৈশিষ্ট্যের প্রকার

কিছু বৈশিষ্ট্য রয়েছে যা স্লাইড এপিআই-তে বিভিন্ন ধরণের বস্তুর মধ্যে সাধারণ:

সম্পত্তি	বর্ণনা
রঙ	স্লাইড এপিআই-এর রঙগুলি হয় একটি RGB মান বা একটি থিম রঙের একটি রেফারেন্স হতে পারে। থিমের রঙগুলিকে নাম দ্বারা উল্লেখ করা হয় (উদাহরণস্বরূপ "DARK1") এবং একটি পৃষ্ঠার রঙের স্কিম ব্যবহার করে RGB মানগুলিতে ম্যাপ করা যেতে পারে। স্লাইড সম্পাদকে উপস্থাপনার থিম পরিবর্তন করার সময় এই রঙের স্কিমটি সাধারণত আপডেট করা হয়।
ভরাট	ভরাট একটি বস্তুর ভিতরে খালি স্থানের রেন্ডারিং প্রতিনিধিত্ব করে। স্লাইডে সবচেয়ে বেশি সমর্থিত ফিল হল একটি কঠিন ভরাট, যেখানে একটি বস্তুর অভ্যন্তরভাগ একটি একক কঠিন রঙে পূর্ণ হয়। পৃষ্ঠাগুলির ব্যাকগ্রাউন্ডের জন্যও ফিলস ব্যবহার করা যেতে পারে।
রূপরেখা	রূপরেখাটি পৃষ্ঠা উপাদানটিকে ঘিরে থাকা লাইনের সেটকে উপস্থাপন করে। লাইনের রঙ একটি ফিল দিয়ে নিয়ন্ত্রিত হয়। কলাররা রূপরেখার প্রস্থ এবং ড্যাশ শৈলীও সামঞ্জস্য করতে পারে।
ছায়া	ছায়া একটি চাক্ষুষ প্রভাব প্রতিনিধিত্ব করে বস্তু দ্বারা নিক্ষিপ্ত একটি শারীরিক ছায়া নকল করার জন্য। বর্তমানে, স্লাইড এপিআই-এর ছায়াগুলি শুধুমাত্র পঠিত হয়৷

বৈশিষ্ট্য আপডেট করা হচ্ছে

একটি প্রপার্টি আপডেট করতে, উপযুক্ত Update ... Properties একটি ব্যাচআপডেট কলে প্রপার্টি অনুরোধ করুন—উদাহরণস্বরূপ, আকৃতির জন্য UpdateShapeProperties । এই অনুরোধগুলি একটি সম্পূর্ণ বৈশিষ্ট্য বার্তা গ্রহণ করে এবং বৈশিষ্ট্য বার্তার কোন ক্ষেত্রগুলি আপডেট করা উচিত তা নির্ধারণ করতে ফিল্ড মাস্ক ব্যবহার করতে পারে।

* এর একটি ফিল্ড মাস্ককে ওয়াইল্ডকার্ডের মতো বিবেচনা করা হয় এবং একটি বার্তায় প্রতিটি ক্ষেত্র নির্দিষ্ট করার জন্য শর্টহ্যান্ড। ভবিষ্যতে API আপডেট করা হলে ওয়াইল্ডকার্ড সিনট্যাক্স অবাঞ্ছিত ফলাফল তৈরি করতে পারে, কারণ শুধুমাত্র পঠনযোগ্য ক্ষেত্র এবং নতুন যোগ করা ক্ষেত্র ত্রুটির কারণ হতে পারে। উত্পাদন অ্যাপ্লিকেশনের জন্য, ফিল্ড মাস্কগুলিতে আপডেট করা নির্দিষ্ট ক্ষেত্রগুলিকে সর্বদা তালিকাভুক্ত করুন এবং * ওয়াইল্ডকার্ড ব্যবহার করা এড়িয়ে চলুন।

সম্পত্তির উত্তরাধিকার

একটি পৃষ্ঠা বা পৃষ্ঠা উপাদান তার মূল বস্তু থেকে বৈশিষ্ট্য উত্তরাধিকারসূত্রে পেতে পারে। একটি বস্তুর বৈশিষ্ট্যগুলি, যা এটি সংজ্ঞায়িত করে এবং যা এটি উত্তরাধিকারসূত্রে পায়, তার চূড়ান্ত চাক্ষুষ চেহারা নির্ধারণ করে।

• পৃষ্ঠা বৈশিষ্ট্য - একটি পৃষ্ঠা এমন কোনো বৈশিষ্ট্য উত্তরাধিকারসূত্রে পায় যা এটি সংজ্ঞায়িত করে না, তবে এটি যে লেআউট বা মাস্টারের উপর ভিত্তি করে তা সংজ্ঞায়িত করা হয়।
• আকৃতির বৈশিষ্ট্য — একটি আকৃতিকে স্থানধারক হিসাবে চিহ্নিত করা যেতে পারে, যা আপনাকে স্পষ্টভাবে অন্য স্থানধারক আকৃতির (পৃষ্ঠার মূল বিন্যাসে বা মাস্টারে) উল্লেখ করতে দেয় যেখান থেকে বৈশিষ্ট্যগুলি উত্তরাধিকার সূত্রে পাওয়া যায়।

এই ধারণাগুলি নিম্নলিখিত অনুচ্ছেদে আরও ব্যাখ্যা করা হয়েছে।

পৃষ্ঠার বৈশিষ্ট্যের উত্তরাধিকার

স্লাইড, লেআউট এবং মাস্টারের গঠন প্রেজেন্টেশনের মধ্যে একটি উত্তরাধিকার অনুক্রমকে সংজ্ঞায়িত করে: স্লাইডগুলি লেআউট থেকে উত্তরাধিকারসূত্রে পাওয়া যায় এবং লেআউটগুলি মাস্টারদের থেকে উত্তরাধিকার সূত্রে প্রাপ্ত। একটি স্লাইডের প্যারেন্ট লেআউট এবং মাস্টার স্লাইডের স্লাইড প্রোপার্টিজ ক্ষেত্রে নির্দিষ্ট করা আছে।

একটি পৃষ্ঠা একটি মূল পৃষ্ঠা থেকে পটভূমি এবং রঙের স্কিম এর মতো বৈশিষ্ট্যগুলি উত্তরাধিকার সূত্রে পেতে পারে৷ একটি সম্পত্তির উত্তরাধিকারী হতে, চাইল্ড পৃষ্ঠাটি তার PageProperties বার্তায় সেই সম্পত্তির জন্য একটি মান সেট করে না। অভিভাবক দ্বারা সংজ্ঞায়িত মান "ওভাররাইড" না করে, পৃষ্ঠাটি উত্তরাধিকারসূত্রে পাওয়া মান গ্রহণ করে।

নিম্নলিখিত চিত্রটি একটি লেআউট থেকে একটি স্লাইডের উত্তরাধিকারী বৈশিষ্ট্যগুলি দেখায়, যা একটি মাস্টার থেকে উত্তরাধিকারসূত্রে প্রাপ্ত হয়:

একটি স্লাইড রেন্ডার করতে ব্যবহৃত বৈশিষ্ট্যগুলি এটি সংজ্ঞায়িত করে এবং যা এটি উত্তরাধিকারসূত্রে পায় তার সংমিশ্রণ। এই উদাহরণে স্লাইড 1 রেন্ডার করতে ব্যবহৃত সমাধানকৃত মানগুলি নিম্নরূপ:

• PropertyA হল "লাল"।
• প্রপার্টি বি হল "কমলা"।

যে পৃষ্ঠার কোনো অভিভাবক নেই সেটি সংজ্ঞায়িত করে না এমন কোনো বৈশিষ্ট্যের জন্য Google স্লাইড থেকে ডিফল্ট মান উত্তরাধিকারসূত্রে পায়।

আকৃতির বৈশিষ্ট্যের উত্তরাধিকার

আকারগুলি অন্যান্য আকার থেকে বৈশিষ্ট্যগুলি যেমন পূরণ, রূপরেখা বা ছায়ার উত্তরাধিকারী হতে পারে। একটি আকৃতি হল একটি স্থানধারক যদি এর Shape.placeholder ক্ষেত্র সেট করা থাকে। চাইল্ড প্লেসহোল্ডারের Shape.placeholder.parentObjectId ক্ষেত্রটি এর মূল স্থানধারককে চিহ্নিত করে। আপনি যখন একটি লেআউটের উপর ভিত্তি করে একটি নতুন স্লাইড তৈরি করেন, সেই লেআউটের যেকোনো স্থানধারক নতুন স্লাইডে চাইল্ড শেপ হিসেবে উপস্থিত হয়। একইভাবে, মাস্টার পৃষ্ঠাগুলির স্থানধারকগুলি লেআউটগুলির স্থানধারকগুলির পিতামাতা হিসাবে কাজ করতে পারে৷

আপনি স্লাইড এডিটর ব্যবহার করে স্থানধারক তৈরি করতে পারেন, কিন্তু স্লাইড এপিআই ব্যবহার না করে।

এই উত্তরাধিকার শ্রেণিবিন্যাস সংজ্ঞায়িত করে, চাইল্ড পেজটি তার ShapeProperties বার্তায় সেই মানটি সেট না করে একটি সম্পত্তির উত্তরাধিকারী হয়। পিতামাতার দ্বারা সংজ্ঞায়িত মানকে অগ্রাহ্য না করে, শিশুর আকার উত্তরাধিকারসূত্রে পাওয়া মানকে গ্রহণ করে।

নিম্নলিখিত চিত্রটি একটি স্লাইড, একটি বিন্যাস এবং একটি মাস্টারের মধ্যে থাকা তিনটি স্থানধারকের মধ্যে বৈশিষ্ট্যগুলির উত্তরাধিকার দেখায়:

একটি স্থানধারক আকৃতি রেন্ডার করতে ব্যবহৃত বৈশিষ্ট্যগুলি যা এটি সংজ্ঞায়িত করে এবং যা এটি উত্তরাধিকারসূত্রে পায় তার সংমিশ্রণ। এই উদাহরণে এই আকারগুলির জন্য সমাধান করা মানগুলি নিম্নরূপ:

• স্থানধারক1: প্রপার্টিA কে "হলুদ" হিসাবে রেন্ডার করা হয়েছে, প্রোপার্টি B কে "সবুজ" হিসাবে রেন্ডার করা হয়েছে।
• স্থানধারক2: সম্পত্তি A "হলুদ" হিসাবে রেন্ডার করা হয়েছে, সম্পত্তি B "বেগুনি" হিসাবে।
• স্থানধারক3: সম্পত্তি A "হলুদ" হিসাবে রেন্ডার করা হয়েছে, সম্পত্তি B "বেগুনি" হিসাবে।

আকারগুলি হল একমাত্র ধরণের পৃষ্ঠা উপাদান যার পিতামাতা থাকতে পারে। অন্যান্য ধরনের, যেমন ছবি, টেবিল এবং চার্ট, স্থানধারক হতে পারে না এবং পিতামাতা থাকতে পারে না।

যখন একটি আকৃতির কোনো অভিভাবক থাকে না, তখন যে কোনো মান যা এটি সেট করে না সেগুলি স্বয়ংক্রিয়ভাবে অ্যাপ্লিকেশন ডিফল্টের সাথে পপুলেট হয়ে যায়।

PropertyState ব্যবহার করে বৈশিষ্ট্য "লুকানো"

PropertyState গণনা নিয়ন্ত্রণ করে যে একটি আকৃতির সম্পত্তি আসলে রেন্ডারিংয়ের জন্য ব্যবহার করা হয় কিনা, অথবা যদি মানটি শুধুমাত্র সন্তানের আকার দ্বারা উত্তরাধিকারের জন্য ব্যবহার করা হয়। পৃষ্ঠায় আকৃতি রেন্ডার করার সময় NOT_RENDERED সম্পত্তির অবস্থা সহ একটি সম্পত্তি ব্যবহার করা হবে না, তবে যে বাচ্চাদের RENDERED এর সংশ্লিষ্ট সম্পত্তির অবস্থা রয়েছে সেগুলি এখনও এই সম্পত্তির উত্তরাধিকারী হতে পারে।

একটি প্রপার্টি আপডেট করা তার প্রপার্টি স্টেটকে 'রেন্ডারেড'-এ সেট করে, যদি না আপনি একই অনুরোধে অন্য কোনো মানতে স্টেট সেট করেন।

নিম্নলিখিত চিত্রটি তিনটি স্থানধারকের মধ্যে সম্পত্তির উত্তরাধিকার দেখায় যা PropertyState ক্ষেত্রকে ম্যানিপুলেট করে:

আকৃতি বৈশিষ্ট্যের রেন্ডারিং PropertyState ক্ষেত্রের দ্বারা প্রভাবিত হতে পারে। এই উদাহরণে এই আকারগুলির জন্য সমাধান করা মানগুলি নিম্নরূপ:

• Placeholder1: propertyA কে "Red" হিসেবে রেন্ডার করা হয়েছে।
• স্থানধারক2: সম্পত্তিA রেন্ডার করা হয় না। যদি এটি আউটলাইন সম্পত্তি হয়, তাহলে Placeholder2-এর কোনো রূপরেখা থাকবে না।
• স্থানধারক3: সম্পত্তিA রেন্ডার করা হয় না।

PropertyState গণনার আরও একটি সম্ভাব্য মান আছে: INHERIT প্রপার্টি স্টেটের অর্থ হল সম্পত্তি স্টেট নিজেই উত্তরাধিকার সূত্রে প্রাপ্ত, এবং পিতামাতার মান ব্যবহার করা উচিত। কোনো পিতামাতা ছাড়া আকৃতির INHERIT এর সম্পত্তির অবস্থা থাকতে পারে না।