// Aqsis
// Copyright (c) 1997 - 2001, Paul C. Gregory
//
// Contact: pgregory@aqsis.com
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public
// License as published by the Free Software Foundation; either
// version 2 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

/**
 * Copyright (C) 2006-2007  NTT DATA CORPORATION
 * 
 * Version: 1.0.0 2007/04/01
 *  
 */
package net.cellcomputing.himawari.library;

import static net.cellcomputing.himawari.library.EqModeBlock.*;

/**
 * Define the context that exists between calls to RiObjectBegin/RiObjectEnd.<br>
 *  RiObjectBegin/RiObjectEndが呼ばれている間に存在する、コンテキストを定義する。
 * 
 * @author NTT DATA Corporation
 */
public strictfp class CqObjectModeBlock extends CqModeBlock
{
	
	/**
	 * コンストラクタ。　初期値の設定。
	 * @param pconParent	前のコンテキスト
	 */
	public CqObjectModeBlock( final CqModeBlock pconParent )
	{
		super(pconParent, Object);
	 
		// Create new Attributes as they must be pushed/popped by the state change.
		// 状態の変化で変わるアトリビュートを新しく作成。
		m_pattrCurrent = new CqAttributes();
	    m_pattrCurrent.AddRef();
		m_ptransCurrent = new CqTransform(pconParent.m_ptransCurrent );
	}
	

	/**
	 * デストラクタ。<br>
	 * 参照を消去。　(参照カウンタをデクリメント。)
	 * @see net.cellcomputing.himawari.library.CqModeBlock#destruct()
	 */
	@Override
	public void destruct()
	{
		m_pattrCurrent.Release();
	}


    /** 
     * Create a main context.<br>
     * 	メインのコンテキストを作成。
     * 
     * @warning オブジェクトコンテキストの中で、このメソッドが呼ばれた場合エラーとなる。
     * @see net.cellcomputing.himawari.library.CqModeBlock#BeginMainModeBlock()
     */
	@Override
    public CqModeBlock	BeginMainModeBlock()
    {
        return 	null;	// Error
    }		
    
	
    /** 
     * Create a frame context.<br>
     * 	フレームのコンテキストを作成。
     * 
     * @warning ワールドコンテキストの中で、このメソッドが呼ばれた場合エラーとなる。
     * @see net.cellcomputing.himawari.library.CqModeBlock#BeginFrameModeBlock()
     */
	@Override
    public	CqModeBlock	BeginFrameModeBlock()
    {
        return	 null;	// Error
    }		
    
	
    /** 
     * Create a world context.<br>
     * 	ワールドのコンテキストを作成。
     * 
     * @warning ワールドコンテキストの中で、このメソッドが呼ばれた場合エラーとなる。
     * @see net.cellcomputing.himawari.library.CqModeBlock#BeginWorldModeBlock()
     */
	@Override
    public CqModeBlock	BeginWorldModeBlock()
    {
        return	null;	// Error
    }		

	
    /** 
     * Delete the object context.<br>
     * 	オブジェクトコンテキストを消去。
     * 
     * @attention このメソッドのみ、オブジェクトのコンテキストを消去することができる。
     * @see net.cellcomputing.himawari.library.CqModeBlock#EndObjectModeBlock()
     */
	@Override
    public void	EndObjectModeBlock()
    {
		destruct();
    }

	
    /** 
     * Get a reference to the options at the parent context, <br>
     * as object context doesn't store options.<br>
     * 	親のコンテキストのオプションのゲッタ。<br>　
     *  (オブジェクトコンテキストはオプションをもっていない)
     *  
     * @return 親のオプション
     * @see net.cellcomputing.himawari.library.CqModeBlock#optCurrent()
     */
	@Override
    public	CqOptions	optCurrent()
    {
        return ( pconParent().optCurrent() );
    }
    
    
	 /** 
     * Get a pointer to the attributes at the parent context, <br>
     * as object context doesn't store attributes.<br>
     * 	アトリビュートのゲッタ。<br>　
     *  (オブジェクトコンテキストはアトリビュートを保存しないため、親のアトリビュートを返す。)
     * 
     * @return 	親のアトリビュートの参照
     * @see net.cellcomputing.himawari.library.CqModeBlock#pattrCurrent()
     */
	@Override
    public CqAttributes pattrCurrent()
    {
        return ( pconParent().pattrCurrent() );
    }
	
	
	/** 
     * Get a pointer suitable for writing to the attributes at the parent context, <br>
     * as object context doesn't store attributes.<br>
     * 	アトリビュートの書き換えのためのゲッタ。
     * 　オブジェクトは、アトリビュートを持たないため、このメソッド呼び出すとエラーとなる。
     *  
     * @return 	null
     * @see net.cellcomputing.himawari.library.CqModeBlock#pattrWriteCurrent()
     */
	@Override
    public CqAttributes pattrWriteCurrent()
    {
		//　Illegal to change attributes here.
		//　オブジェクトブロックの中でアトリビュートを変更するとはできない。
        assert( false ); return ( null );	
    }	

}