---
title: "Öğeler, versiyonlar ve @adlar"
description: "Oyuncular, mekânlar, aksesuarlar ve stiller; versiyonları ve referans görselleri olan öğelerdir ve her planda @adlarıyla çağrılır."
url: https://www.filmsquare.ai/docs/tr/concepts/elements/
lang: tr
section: concepts
updated: 2026-11-15
mcp: [get_script, view_media, upload_file, find_actions, run_action]
---

# Öğeler, versiyonlar ve @adlar

Öğe, her planda aynı görünmesi gereken bir şeydir: bir oyuncu, bir mekân, bir aksesuar ya da bir stil. Her öğenin bir
`@ad` (handle), referans görselleri ve versiyonları var. Birini bir kez onayla, sonra her planda adıyla çağır.

![Kartlar olarak oyuncuları, mekânları ve aksesuarları gösteren, tür başına filtresi olan Elements ekranı](https://www.filmsquare.ai/docs/shots/en/elements-desktop.webp)

## Öğe türleri

| Tür | Uygulamada | Departman |
| --- | --- | --- |
| Character | Oyuncu | [Oyuncu seçimi](https://www.filmsquare.ai/docs/tr/departments/casting/), [Kostüm](https://www.filmsquare.ai/docs/tr/departments/wardrobe/) |
| Location | Mekân | [Mekân](https://www.filmsquare.ai/docs/tr/departments/sets/) |
| Prop | Aksesuar | [Aksesuar](https://www.filmsquare.ai/docs/tr/departments/props/) |
| Style | Stil | Bir görünüm: kamera, lens, ışık, renk düzeltme, film stoğu. Bkz. [Stiller](https://www.filmsquare.ai/docs/tr/concepts/styles/) |

Kostüm kendi başına bir öğe değildir: bir oyuncunun sahne başına [görünümüdür](https://www.filmsquare.ai/docs/tr/departments/wardrobe/).

## @adlar

Her öğenin `@anna` ya da `@backlot-street` gibi bir adı var. Bir öğeyi getirmek için bir prompt'ta, plan tarifinde ya da
composer'da `@` yaz. Filmsquare o zaman öğenin referans görsellerini, planın ölçeğine ve açısına göre seçerek senin için
çekime ekler.

**Elements** ekranında **Copy @handle** onu kopyalar. **Search elements or @handle** bir tanesini bulur.

## Öğeler nerede durur

Bir öğe tek bir yapıma ya da bütün çalışma alanına aittir ("Every production in this workspace"). Çalışma alanı
genelindeki öğe her yapımda kullanılabilir; bir yapımın kendi öğesi yalnızca orada. Bir yapımda bunlarla **Cast & sets →
Cast**, **Locations** ve **Props** altında, stillerle **Create → Mood** altında çalışırsın. Bir yapımın kendi **Elements**
sayfası da var, yeni bir yapımın **Home** ekranında bir düğmeyle: o yapımın öğelerini ve kullandığı çalışma alanı genelindeki
öğeleri (**Every production** ile işaretli), örneğin içe aktarılan çekimlerinin adını verdiklerini gösterir. Oraya
eklediğin o yapımda kalır. Çalışma alanı genelindeki bir öğede yapılan değişiklik her yerde geçerlidir ve ekibi yalnızca
bir yapımın kendi öğelerine atarsın.

## Öğe yapmak

- **Dökümden:** senaryo dökümü bulduğu oyuncuları, mekânları ve aksesuarları getirir.
- **Add elements:** Elements sayfasında fotoğrafları herhangi bir yere bırak (ya da birkaçını seç). Her biri, dosya
  adından okunan bir tür ve adla taslak karta dönüşür (`chr_ines_v3.png` oyuncu Ines'tir). İkisini de kontrol et, sonra
  hepsini birden **Add** (ekle) ile ekle. Her fotoğraf öğenin ilk referansı olur.
- **Tarif et:** bir **Kind** (tür) ve bir **Name** (ad) seç ve bir cümle yaz. Filmsquare bir referans sayfası render alır ve
  ilkini kullanır.
- **Save as element:** beğendiğin bir çekimi oyuncuya, mekâna ya da aksesuara çevir. Çekim onun ilk referansı olur.
- **Bir etiketten:** **Script → Tagging** altında bir etiketin yanındaki **Create**, adını verdiği oyuncuyu, mekânı ya da
  aksesuarı yapar.
- **New look:** **Create → Mood** altında, seçtiğin görsellerden bir stil yap. Bkz.
  [Tuval](https://www.filmsquare.ai/docs/tr/working-together/canvas/#looks).
- **New style:** **Create → Styles** altında bir stil kılavuzu yaz ve referans görselleri ekle, ya da kütüphaneden birini kullan.
  Bkz. [Stiller](https://www.filmsquare.ai/docs/tr/concepts/styles/).

## Versiyonlar

Bir öğenin görünüşündeki her değişiklik yeni bir versiyondur. Versiyonlar yapıldıktan sonra hiç değişmez, böylece birini
kullanan planlar yeniden üretilebilir kalır. En yeni versiyon **Current** (güncel) yazar; bir plan daha eski bir versiyona
sabitlenmedikçe planlar güncel versiyonu kullanır.

Öğenin sayfasında **New version**, güncel versiyonu bütün referanslarıyla sonraki olarak kopyalar. Sonra onda referans ekle
ya da değiştir.

![Versiyonları, referans görselleri ve sayfaları olan bir öğenin sayfası](https://www.filmsquare.ai/docs/shots/en/element-detail-desktop.webp)

> [!NOTE]
> Bir versiyonla bir çekim yapıldıktan sonra o versiyonun referansları donar. Referans eklemek için yeni bir versiyon yap.
> API, çıkış yoluyla birlikte `409 element_version_frozen` döner.

## Referanslar ve sayfalar

Referans, öğenin rolü olan bir resmidir: önden, dörtte üç, profil, arkadan, boydan, turnaround, ifade, detay, geniş ve
birkaç tane daha. **Add reference** bir tane yükler. Güncel versiyonun bir görselinin yanındaki
çarpı onu kaldırır: Filmsquare onsuz yeni bir versiyon yapar ve eski versiyonlar onu tutar.

**Sheet** (sayfa), öğenin referans olarak kullanılmak üzere render alınmış temiz bir görünümüdür. Öğenin sayfasından bir
tane render al; doğru olunca **Sign off as reference** (referans olarak onayla): Filmsquare o resim eklenmiş yeni bir
versiyon yapar.

## Versiyonlar ve onay

Bir öğenin yeni bir versiyonu (v2 ve üstü), onaylanmış işte bir değişikliktir. Öğeyi kullanan, hâlâ çalışılan her bölümde
departmanını geçersiz kılar:

| Öğe | Geçersiz kalan departmanlar |
| --- | --- |
| Oyuncu | Oyuncu seçimi, Kostüm, Seslendirme |
| Mekân | Mekân |
| Aksesuar | Aksesuar |

Yeni bir öğe (v1) kılmaz: onu getiren döküm zaten onaylanmıştı. Bkz.
[Onay ve kapılar](https://www.filmsquare.ai/docs/tr/concepts/sign-off-and-gates/#when-a-sign-off-goes-stale).

## Arşivlemek

**Archive…** bir öğeyi listelerden çıkarır. Onu kullanan planlar ve çekimler geçmişini korur. Hiçbir şey silinmez.

## Kendi Claude'unla

`get_script` bir yapımın zaten sahip olduğu @adları döner, böylece döküm onları yeniden kullanır. `view_media` Claude'a bir
referans resmi gösterir; `upload_file` bir resmi referans için yapım varlığı olarak ekler. Versiyonlar, referanslar ve
sayfalar `find_actions` ve `run_action` üzerinden gider (örneğin `forkElementVersion`, `generateForElement`,
`acceptElementTake`). `removeElementReferences` bir öğeden eski görselleri çıkarır: onsuz yeni bir versiyon güncel olur ve
önceki versiyonlar kendilerininkini tutar. Bkz. [Claude neler yapabilir](https://www.filmsquare.ai/docs/tr/claude/tools/).
